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SECTION 1 

INTRODUCTION TO RTX 


This section presents an overview of Computer Automation's Real Time-Executive (RTX) 
program which operates on all ALPHA-16 and LSI- processors. The following discussion 
is concerned with three basic questions: 

1. What is RTX? 

2. When should RTX be used? 

3. What does an application program look like? 


y 

ifeuv 


WHAT IS RTX? 


is a modular package of service routines that handles both the overhead functions 
( and the scheduling services associated with a real-time environment. Modular con¬ 
struction allows you to select only the portions of RTX required for your application. 
Real-time environment means that if your application requires that certain tasks be 
performed at selected intervals or in response to an external signal or event, then 
RTX will manage the orderly interruption and resumption of your program. RTX does 
all the overhead functions to maintain and direct the execution of your application 
^uring both normal and real-time processing. 


RTX is also a powerful multi-task executive that controls all tasks of the overall 
\pplication. These tasks include priority scheduling, response and assignment, 
interrupt servicing, and communication among RTX tasks and user-developed handlers. 
Overall task control: 



Allows the application program to be designed as a number of either inter-related 
or subordinate tasks. The nature of the application determines the task relation¬ 
ships. RTX will completely handle the switching from task to task as required. 

Allows the application program to dynamically define (and redefine) the priority 
level of the various tasks in the application using RTX service routines. This 
is a software priority which is then used by the RTX scheduler function to direct 
the sequence of task execution. 


3. Allows RTX priority scheduling, response and assignment to share the computer 
among tasks with equal priority. When all tasks of the highest priority are 
temporarily waiting for some event to occur, the next highest priority level is 
scheduled in the same manner. 

4. Allows response to interrupts, as generated, because the user provides the 
interrupt instructions which transfer control to an interrupt service routine. 
This interrupt service routine will save status (using an RTX function) , perform 
the necessary instructions to assure no data loss, and then restore status (using 
an RTX function). This routine can also cause a lower priority routine to be 
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( “'cheduled if additional processing of the interrupt data is required; the lower 
priority routine can be temporarily deferred until any higher priority tasks have 
had*their turn at executing. 

. Allows the various tasks in the application to communicate between themselves (or 
with RTX) through RTX communication routines. These routines allow a task to 
' uniquely identify the communication request and then post it. Posting consists 
of presenting information to, or requesting information from, another task. This 
facility may be used to operate simply as a signaling device, or it may be as 
complex as both a signaling and parametric (pointer-passing) function.* 

11 of these RTX features combine to produce a multi-tasking, real-time scheduling 
xecutive that is, despite its small size, the most powerful and easy to use system 
f its kind on the market. Figure 1-1 illustrates a typical example of RTX. 


.2 WHEN SHOULD RTX BE USED? 

he most significant reason for using RTX is that your application program requires a 
eajC ime environment. Real-time environments are found in many circumstances, 

■arf0hg from high speed data acquisition to occasional sampling of an electro- 
te{ .nical device such as a relay. The basic criterion is that a need exists for the 
ppiication to communicate with some external device or event in a time-dependent 
lanner. If this criterion is met, then RTX is a suitable vehicle for defining the 
elationship between the external device or event and the application programming 
asks which control and service that device or event. Some of the more obvious 
pplications are: 

. ommunications 

Message Switching 
# Store-and-Forward 

v Networks 

Reservation Systems 


3 . 


c 


c 


Process Control 

Plant Operations 
Flow Monitoring 
Equipment Direction 
X-Y Positioning 
Petro-chemical Applications 


Data Acquisition 

Test cells, such as automotive or airframe/aircraft 

Traffic Control 

Instrumentation Control 

Source Data Entry 

Oil Field Data Monitoring 


2. Medical Data Processing 
EKG/EEG Analysis 
Patient Monitoring 
Cardiac Monitoring 
Patient Billing 

ct- 
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5. Security Systems 

Plant/Facility Security 
X-Ray Security Systems 
Video Transmission Systems 

6. Financial Transactions 

Point-of-Sale 
Automatic Banking 
Inventory Control 


1.3 WHAT DOES AN APPLICATION PROGRAM LOOK LIKE? 

RTX allows the user to construct his application in modules. These modules are then 
combined with RTX during the loading process to produce the final application program. 
The user may choose any arrangement of his program into modules that suit his needs. 
Figure 1-1 shows a general diagram of this type of arrangement. This modularity 
concept applies not only to the user's application, but also to RTX itself. The RTX 
ipackage is simply a library of separate subroutines which may be referenced by the 
user's modules; certain of the RTX subroutines in turn reference others, and the 
linking of all required modules (performed by the LAMBDA loader or by the OS:LNK 
program) results in a configuration consisting of only those modules needed for the 
application. Figure 1-2 shows how the modules and user programs are loaded into 
memory and the size of the individual RTX modules. Keep in mind that the only RTX 
modules actually loaded for a given program will be the ones required by the 
particular program. 


1.4 DEFINITIONS 

1. Activity: A task which has been initialized (via BEGIN: for example) and is 
receiving support from RTX. 

2. Common Subroutines: Subroutines which may be used by two or more different 
activities concurrently. These require special coding to provide reentrant 
capability. 

3. Coordination Number: A decimal integer used to identify a task to RTX. It is 
analagous to a telephone number in that it is used to "connect” a task to another 
task or to the DELAY: process. 

4. Interrupt Data Processing: That portion of code that processes the data obtained 
by an Interrupt Service routine. 

5. Interrupt Service: That portion of code that must be executed immediately after 
the interrupt occurs (so as not to lose data) . It should be limited to only that 
code which is necessary to assure no data loss. 

6. Inter-Task Coordination: A method for tasks to communicate and pass parameters * 
using two 16-bit computer words. These words may contain any information, such 
as a table address, a pointer to a list of values, or a value itself. 
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(2) CAI-Supplied Tasks 
(IOX) 


(3) User-written Application 
Tasks (as.many as 
needed) 


(1) RTX Nucleus provides control, scheduling, priority handling, 

(2) CAI-supplied tasks provide handlers for I/O (such as printers, tapes, 
etc.,), for communications (such as BISYNC, ASYNC, etc.), and ethers. 

(3) The user need only supply tasks which perform his application’s work, 
while utilizing the CAI-supplied software for support. 


Figure 1-1. ‘ Typical Example of RTX 
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Literals and Interrupts 


User - Mainline (i.e., RTX 
Initialization), Tasks, 
Data/Work Areas and 
Interrupt Service Routines 


IPX - TTY, Line Printer, 
CRT and Paper Tape 
Tables and’Drivers 


IPX - Card Reader and 
Mag Tape 

Tables and Drivers 


IPX - Disk 
Tables and Drivers 


IPX Scheduler 


RTX Nucleus 

RTX:, BEGIN:, END:, . . . , 

List Pinters and 
Scheduler 


Debug (ZBG) 


IPX Controls 
IPNIT:, EPR:, EOF:, 

SIP:, . . ., SINT:, IP: 

and EOFCK: 


RTX Services 

DECPR:, DELAY:, GET:, PUT: 
. . ., SUBR:, SUBX:, INTG: 
and RTOSZ: 


File Manager 
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Main Line: A short initializing sequence which resets all task table pointers, 
and then begins one or more tasks. (Tasks may also be begun by other tasks, or 
qpon an interrupt from an external device.) 


8. Priority: A software defined method for assigning (and re-assigning) the rela- 

( tive importance of a task to RTX. 

9. Re-entrant Programs: A program specifically written such that it may be directly 
entered by more than one program, concurrently. Under. RTX, this is necessary 
only if two or more Interrupt Service routines require immediate use of the same 
program. For example, Interrupt Service A calls routine C. While C is executing. 
Interrupt Service B becomes active and also calls routine C. If C were not re- 

* entrant, this second call to C would replace the return address at C's entry 
point, causing the return address for routine A to be lost. 

10. Task: A program or set of programs which operate to perform a specific function 
within the real-time application. 

11^ Work Area: An area of storage dedicated to'table space for RTX. This table 
w.'contains all the necessary information for RTX to perform its functions. Its 
usage is dynamic and is dependent upon the maximum concurrent usage of RTX 
( functions. 


c 

f 



f 

V. 


**l 
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SECTION 2 
RTX ORGANIZATION 


P 


RTX is basically a collection of functions (subroutines) and a user-supplied work 
area, which are linked to the user's Mainline sequence and tasks prior to execution. 
Each RTX function may be called as a subroutine by the user as it is needed, to 
perform a specific job. (See below for descriptions and calling sequences of these 
functions.) RTX also includes a task scheduler (SCHED:) which is used to execute the 
task of highest priority.. The priority of a task is defined when the task is begun, 
and may be changed by the task, using the SETPR:, INCPR:, and DECPR: functions. 
Priorities may range from 1 to 8191, with larger numbers representing the higher 
priority. * 


The scheduler maintains a "Ready" list of each task in order of priority. The highest 
priority task is executed until it suspends itself by calling any of the following 
RTX functions: 


c 


b 


DELAY: (unless altering or cancelling a previous delay) 

GET: (if no corresponding PUT: yet, and not a cancel call) 

SUBR: (if the common subroutine is busy) 

PAUSE: (essentially reschedules the pausing task at the same priority) 

IO: (BEGINS, at I/O completion time, the normal or abnormal return at the 

same priority) 

SETPR: (if the new priority is lower than that of another task) 

DECPR: (if the new priority is lower than that of another task) 


l Once the task has been suspended, RTX executes the new highest priority task. The 
j rule for determining the highest of equal priority tasks is, "first in - first out", 
■! Thus, if a task suspends itself, it thereby becomes "last in" within its priority. 

( In addition to the user-invoked suspends listed above, occurrence of an interrupt 
will cause a task to be suspended, if the new priority is higher than that of the 
current task. An interrupt is defined to be: 


1 . 




A hardware (external) interrupt, with INTQ: or INTAC: attached, or 
A software (internal) interrupt: 
a DELAY: expiring 

a PUT: which satisfies an outstanding GET: 

a SUBX, UNLK: , or UNPR:, w'ith a higher priority task waiting 
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In addition, an Input Output Executive package (IOX) is available, which may be 

linked,to run in conjunction with RTX. Its function is to perform I/O operations to 

the standard CAI I/O devices (teletype, high speed paper tape reader and punch, card 

reader, magnetic tape units, and disk) and resolve confilicts of concurrent I/O 

^ Mization. 


A File Manager operates in conjunction with IOX. It enables the user to communicate 
with data files by name, independent of the physical medium storing the file. 
Requests for access are made through IOX using Logical Units (LUNs). 


2 .1 WORK AREA (USER BLOCKS) 

The user must supply a contiguous work area for RTX to build its tables. The address 
and length of this work area is specified in the call to the RTX: function. It is 
grouped by RTX into blocks of five words each, and there must be at least two of 
these blocks (10 words) reserved; otherwise an error return will be made from the 
| initialization routine. Table 2-1 gives a list of the RTX functions which allocate 
af^de-allocate this area. The left hand column*denotes the number of blocks alio- 
c^Od (+) or de-allocated (-) by the function in the right-hand column. The user 
[ it supply sufficient work area for the maximum number of five-word blocks which 
may be allocated at any one time * 


2.2 RTX FUNCTIONS : 


2.^.1 


Initialize Work Area (RTX:) 


Calling Sequence: 


N 

EQU 

(NUMBER OF 

TASK BLOCKS) 

WKAREA 

RES 

n+n+n+n+n. 

0 AREA FOR BLOCKS 


JST 

RTX: 



DATA 

N 

# OF CONCURRENT ACTIVITIES 


DATA 

WKAREA 



ERROR 

RETURN 

WORK AREA EXCEEDED 


NORMAL 

RETURN 



Returns With: 


INTERRUPTS ENABLED 
OVERFLOW RESET 
WORD MODE 

A REGISTER-CURRENT RTX REVISION NUMBER IN ASCII 

X REGISTER-CURRENT RTX REVISION NUMBER IN ASCII 


This subroutine is called in the user's Mainline sequence to initialize the working 
area of RTX. The work area is broken into N blocks of five words each, which are 
then used by the remainder of RTX during system operation. The number N must be 
I large enough to allow for all concurrent activities. Work area overflow will cause a 
| juroP to the RTX: routine's error return at any subsequent time during the running of 
| the program, not just during the call to RTX:. 

t cc 
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A call to this subroutine causes activation of the RTX Scheduler. 

Upon return, the calling program (normally the user's Mainline 
sequence) is thenceforth considered a task with a priority of 817?. 

In addition to initializing the work area, the RTX: subroutine can also reset all I/O 
tables, if desired; this feature will insure restartability of a user's proqram. The 
feature may be referenced in the user program, if restart capability is required; 
otherwise it may be omitted, thereby shortening the overall length of the program. 
(Upon initial loading, I/O reset is not required before execution.) 
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To include this feature in the RTX: subroutine, simply reference the module "IONIT:" 
in the Mainline sequence; either of the following directives: 


IONIT: REF 
or 

LOAD IONIT: 

( . ■ 

| will serve this purpose. 



• 2.2.2 Initiate New Task (BEGIN:) 



Calling Sequence: 

JST BEGIN: • 

DATA (*) START ADDRESS OF NEW TASK 

DATA PRIORITY OF NEW TASK 


Returns With: 



( 

I 


INTERRUPTS - ENABLED 

OV -— UNCHANGED 

A REGISTER - UNCHANGED 

X REGISTER - UNCHANGED 


| QTE 

When the new task starts executing, the A a nd X registers will 
contain the ^mlues^a^the^Jt ime of t he^ET^toJjBEGTM > f OV will be 
reset, and the computer will be in word mode. 


This subroutine is called to initiate a new task. The task is scheduled and BEGIN: 
then exits to the task Scheduler. This means that the calling program will not 
receive control back immediately if the new ("begun**) activity is of higher priority, 
or if another task* of higher priority is ready to begin execution. 
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Function 

RTX: 

BEGIN: 

END: 

PAUSE: 

PUT: (If a new, unique PUT: and no corresponding GET: is waiting 
for it) < . . 

PUT: (If a new unique PUT: and the corresponding GET: is already 
waiting for it) 

PUT: (To change the information in a previous PUT:) 

PUT: (To cancel an outstanding PUT:) 

GET: (If a new, unique GET: and no corresponding PUT: is waiting 
for it) 

GET: (If a new, unique GET:, and the corresponding PUT: is already 
waiting for it) 

GET: (To replace a previous task currently waiting for a PUT: 
with the current task; the new GET: must be called with the 
same coordination number as the task to be replaced) 

GET: (To cancel an outstanding GET:) 

DELAY: (To initiate a new delay) 

DELAY: (To change the length of an outstanding delay) 

DELAY: (To cancel an outstanding delay) 

INTSV: 

INTRS: 

INTAC: 

INTQ: 

SUBR: (If the common subroutine is not already in use) 

SUBR: (If the common subroutine is already in use) 
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Table 2-1. User Blocks For RTX Functions (Continued) 


SUBX: (If no other tasks are waiting to use the common sub¬ 
routine) 


SUBX: (If one or more tasks are waiting to use the common sub¬ 
routine) 


PROT: (If the facility is not already protected) 


PROT: (if the facility is already protected) 


UNPR: (If no other tasks are waiting to protect the facility) 


UNPR: (If one. or more tasks are waiting to protect the facility) 


LOCK: (If the facility is not already locked) 


LOCK: (If the facility is already locked) 


UNLK: (If no other tasks are waiting to LOCK: the facility) 


ABORT: (In addition, -1 for each resultant SUBX: call where no 

other tasks are waiting to use the common subroutine, and -1 for 
each resultant UNPR: and UNLK: call where no other tasks are 
waiting to PROT: or LOCK: the facility) 


GETPR: 


SETPR: 


INCPR: 


DECPR: 


IOREL: 


i 



0 IOWAT: 

3 or 4 IO: (as follows:) 

+1 For the immediate return +1 For setting a watchdog .timer 
+1 For scheduling +1 if x/O completes before 

scheduling completes 
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C 


NOTE ] 


Priorities are integers from 0 (lowest) to 8191 (highest). Users 
should limit priority to less than 7000 because certain RTX functions 
use those of 7000 and higher. 


.2.3 Terminate Current Task (END:) 
Calling Sequence: 

JST END: 


he current task may terminate itself with a call to END: 
ndcontrol will not return. 


No arguments are required 


H©?£ 


The Mainline sequence (as a result of the JST to RTX:) has a priority 
of 8172. This sequence should begin other necessary tasks and then 
terminate itself by a call to END:. If it does not terminate, no 
tasks of a lower priority can execute. 


c 

.2.4 Suspend Current Task (PAUSE:) 
^ Calling Sequence: 

JST PAUSE: 


Returns With: 



( 


INTERRUPTS ENABLED 

STATUS - UNCHANGED 

A REGISTER —- UNCHANGED 
X REGISTER UNCHANGED 


This subroutine is called by a program which desires to allow other tasks at the same 
priority level to get service. This is useful if a program is unusually long or is a 
closed loop. PAUSE: is essentially similar to a BEGIN:, END: pair, but is less de¬ 
manding on work area space in RTX. 


NOTE 


Programs which loop indefinitely are permissible, but should be used 
carefully since they will block execution of all activities of a 
lower priority. Tasks should begin in response to a stimulus, 
generate the appropriate reaction, and end. 


(C 
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2.2,5 Coordination lumbers 

Before discussing GET:, PUT:, and DELAY: the concept of coordination number must be 
understood. A coordination number is a 16-bit value which is supplied as an argument 
to GET:, PUT:, DELAY:, PROT:, UNPR:, LOCK:, UNLK:, IO: and IOREL:. This number 
serves to identify the activity so that it may be referenced by a later call. 

For GET:, PUT: AND DELAY:, the same coordination number used in the same type of call 
supersedes the previous call. The negative (2's complement) of a coordination 
number cancels the previous call. FORTRAN uses the following coordination numbers, 
and the designer should avoid their re-use: 

F:RBPG address (for LOCK:) 

:FFDC (for LOCK:) 

In addition, all DELAYS performed in IOX and COMX use memory addresses as coordination 
numbers. These memory addresses fall within the IOX or COMX boundaries, or their 
associated tables (CIB’s). Thus, it is strongly suggested that the system designer 
^follow this practice, and use as coordination numbers, only memory addresses of 
^locations within his program. Basically, it is the system designer’s responsibility 
to allocate coordination numbers so that no conflicts arise. 


EiOTE 


Zero has no separate identifiable two's complement, and therefore a 
coordination number of zero should not be used. 

2.2.6 Inter Task Coordination (PUT:/GET:) 


These two facilities are generally used together as a pair. In general, PUT: passes 
32 bits (the A and X registers) to a GET:. Coordination numbers are used to insure 
proper reference. There are no timing restrictions on associated PUT:/GET: pairs. 
(If a task calls GET: before another task has made the corresponding PUT: call, the 
GETting task will suspend until the PUT: is made.) 


Calling Sequence: 


JST 

DATA 

Returns With: 


PUT: 

COORDINATION NUMBER 


INTERRUPTS ENABLED 

STATUS - UNCHANGED 

A REGISTER -— UNCHANGED 
X REGISTER UNCHANGED 

This subroutine is called to do one of three things: 

1. Pass 32 bits to another task; call PUT: with the same (positive) coordination 
number which will be used in the call to GET; 


1/2-7 




Com puterAutomation 


^Lhange the information in a previous PUT:; call PUT: with the same coordination 
number used previously. 


( 


Delete an outstanding PUT:; call PUT: with the 2's complement of the coordination 
number of the PUT: to be deleted. 


| MOT~ 

If a PUT: is issued before the associated GET: is called, one block 
is used from the work area in RTX. If the GET: is called first no 
additional demands are made on the work area. 


2T: 


Calling Sequence: 


JST 

DATA 


GET: 

COORDINATION NUMBER 


Returns With: 



INTERRUPTS ENABLED 

STATUS - UNCHANGED 

A REGISTER FROM ASSOCIATED PUT 

^ X REGISTER - FROM ASSOCIATED PUT 

his subroutine is called for one of three reasons: 

. ^ fo obtain 32 bits (A and X registers) from another task: call GET: with the 
positive coordination number to be used with PUT:. 


To delete a task currently in a GET: waiting for the associated PUT:; call GET: 
with the 2’s complement of the coordination number. 


C > replace a task currently waiting for a PUT: with the current task; call GET: 
■ ^ )ith the same coordination number as the task to be replaced. 


fti GET: is called, control will not be returned until the associated PUT: is 
ssued. 


.2.7 Delay Current Task (DELAY:) (Requires Real-Time Clock Option) 
Cabling Sequence: 

JST DELAY: 

DATA # OF TICKS ON THE CLOCK FOR DELAY 

DATA COORDINATION NUMBER 

Returns with: 



INTERRUPTS - ENABLED 

STATUS - UNCHANGED 
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If deleting or changing an outstanding delay: 

A REGISTER - UNCHANGED 

X REGISTER-UNCHANGED 

If actually executing a delay: 

A REGISTER - COORDINATION NUMBER 

X REGISTER - UNDEFINED 

This subroutine is called for one of three reasons: 

1* To delay the current task for a specified period of time. (The number of ticks 
referred to above is the number of time interrupts from the Real-Time Clock. 

These interrupts normally occur every 10 msec but may be changed by a jumper 
wire. (See the appropriate ALPHA-16 or ALPHA LSI Computer Reference Manual). 

For this call, supply a currently unused positive coordination number. 

* 

2. To delete an outstanding delay. A call to DELAY: with the 2's complement of the 
coordination number of any current delay will delete the delay request (and the 
task that called it). This is useful for deleting a watchdog routine. 

To change an outstanding delay. A call to DELAY: with the coordination number of 
a currently active delay will change the outstanding delay. This is equivalent 
to deleting a task in a delay and immediately starting the same task with a new 
delay. 


3. 
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SECTION 3 


( 

| INTERRUPT PROCESSING 


Most interrupt service routines can be divided into two sections. First, the recog¬ 
nition that the requesting device usually has an immediate need which will result in 
data being lost if it is not met. Second, a subsequent need to perform some pro¬ 
cessing upon that data. In the case of output, the device may not continue to operate 
at full speed if its request is not answered within a certain interval. After meeting 
this very high-speed requirement, the need for continued rapid servicing diminishes 
considerably, until the next request is made. 


TX provides two alternative methods for interrupt service. One is the INTQ: service, 
ihich combines the functions of saving status, queueing or scheduling of support 
^asks, and then dismissing the interrupt since it has been honored. The second is to 
use the INTSV ?t INTAC:, and INTRS: services to provide each of those three functions 
separately. Use of these three functions is described below. 

Upon receiving control after an interrupt, the interrupt handler should immediately 
call INTSV:, to preserve the register status. When control returns, the handler inay 
utilize the registers as required. Processing, at this point, should be restricted 
( 'i the very high speed "lost data'* requirements. The handler may then schedule other 
activities, by calling INTAC:, with the start address and priority as arguments. 
Processing is ended for this phase, by issuing a call to INTRS:, which resumes pro- 
;essing. Normally, the newly scheduled activity will have a high priority. Note, 
however, that the programmer may assign this priority, as distinct from those systems 
where the hardware has the device priorities wired in. When the scheduled processing 
activity receives control, it will be considered a normal activity, and may make use 
of all RTX functions. Interrupts will be enabled, so that other devices which require 
service may receive control during their "lost data’* intervals, after which the 
'stem Scheduler will return control to the highest priority processing program. 


* V 


( 


Clihe A and X register are passed between the scheduling and the scheduled routines, so 
hat word or byte transfer devices can pass the data itself to the processing pro¬ 
grams. After the processing program has finished its task, it may terminate, or it 
may schedule other responding tasks. 

By using INTSV: and INTRS: to save and restore status, the user is relieved of one of 
the most important and error-prone types of coding. With INTAC:, he can schedule 
routines which are normal, interruptable programs, and which can utilize all of RTX * s 
capabilities. - 

Note that the INTSV:, INTRS:, INTAC:, and INTQ: routines are necessary only for the 
user who is using RTX in conjunction with his own special (non-standard) device and 
has written his own interrupt handler for it. The RTX I/O Executive (IOX), discussed 
in Chapter 2 of this manual, contains the necessary I/O handler routines for the 
standard CAI-supplied I/O devices (card reader, teletype, high speed paper tape punch 
and reader, magnetic tape, disk and floppy disk). These standard handlers within IOX 
^ke use of the INTQ: routine internally. 
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3.l(^SAVE ENVIRONMENT (INTSV:) 

Calling Sequence: 

JST INTSV: INTERRUPTS MUST BE DISABLED 

( DATA *PLOC LOCATION OF ENTRY POINT TO INTERRUPT ROUTINE 

Returns With: 

INTERRUPTS-STILL DISABLED 

' STATUS-OV,RESET, WORD MODE 

A REGISTER-SAVED P REGISTER 

X REGISTER-UNCHANGED 

liis subroutine must be called by an interrupt subroutine to save the current 
nvironment. 


'€ 


.2 /"UESTORE ENVIRONMENT (INTRS:) 
falling Sequence: 


JST 


INTRS: 

DOES NOT RETURN 



his subroutine is called by an interrupt subroutine to exit. If RTX was interrupted, 
ontrol is returned to RTX. Otherwise, task control is moved to the block at the top 
f t^ scheduler ready chain and the system Scheduler is entered. 

.( INITIATE A NEW TASK FROM AN INTERRUPT SUBROUTINE (INTAC:) 
i# Calling Sequence: 



JST 

DATA 

DATA 


INTAC: (MUST BE IN WORD MODE) 

(*) START ADDRESS 

PRIORITY 


turns With: 


INTERRUPTS-UNCHANGED 

OV-INDETERMINATE 

A REGISTER-DESTROYED 

X REGISTER——DESTROYED 
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3.4 INTERRUPT SERVICE AND QUEUE TASK (INTQ:) 

This service may be used in place of the. INTSV:, INTRS:, INTAC:, sequence. It is 
functionally identical to the combination of those three services•when they are used 
as follows: 


SUBENT 


ENT 

JST 

DATA 

JST 


INTSV: 

*PLOC 

INTAC: 


SAVE ENVIRONMENT 

QUEUE “TASKC" AT “PRIOR” 


DATA 


TASKC, PRIOR 


INTRS: 


DISMISS INTERRUPT AND GO TO RTX 
SCHEDULER 


The advantage to using INTQ: is that it is faster; i.e., it shortens the period of 
time during which.interrupts are disabled. 


Calling Sequence! 


Returns With: 


ample Usage 


JST * INTQ: 

DATA $,0,0,0 

DATA TASK-ADDRESS 

DATA PRIORITY 

DATA A-REGISTER 

DATA X-REGISTER 

DATA P-LOC 


CALLING LOCATION, 3 TEMPS REQUIRED 

FOR TASK WHICH IS QUEUED 
FOR QUEUED TASK 

VALUE PASSED TO QUEUED TASK IN A 
VALUE PASSED TO QUEUED TASK IN X 
LOCATION OF SAVED P-REGISTER AT ' 
TIME OF INTERRUPT 


DOES NOT RETORN. QUEUES TASK FOR SCHEDULER AND DISMISSES 
INTERRUPT. 


Interrupt for End-of-Block 


EOBENT 


EN T VECTORED INTERRUPT 

JST INTQ: • 

DATA $,0,0,0 

DATA TASKB,PRIORB,0,0,EOBENT 
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DA'fENT 


AREG 

XREG 


JST 

DATA 

DATA 

DATA 

DATA 

DATA 


3 

AREG 

ADDR,FCN 

AREG 

INTQ:‘ 
$/ 0 , 0,0 
TASKA,PRIORA 
0 
0 

DATENT 


VECTORED INTERRUPT 
BLOCK BYTE MODE 
SAVE A-REG 

INPUT THE DATA VALUE 

RESTORE PROPER A-REG AND PASS INPUT 
VALUE TO QUEUED TASK 


A-REG VALUE FOR TASK 
X-REG VALUE FOR TASK 
RETURN POINTER FROM INTERRUPT 


3.5 COMMON SUBROUTINES (REENTRANCE) 

Noj w il1v. different activities are independent of'each other. However/ it is not 
un®iRial to have tWo unrelated programs use the same utility subroutines, therefore 
d£ ning a "common" subroutine. One example would be mathematical functions library 
routines. Rather than duplicating copies in each using program, a single copy is 
loaded, and entered with subroutine calls (JST instructions). If control is within 
the common subroutine when an interrupt occurs, and another program gains control and 
re-calls the subroutine, the second call will destroy the return location of the 
first. When control finally returns to the middle of the interrupted subroutine 
(clearing the interrupt), it will complete its execution, and again return to the 
sed ,d caller. The original caller never sees control come back. The later caller 
gets two returns from one call. This dilemma is referred to as the common subroutine 
prr' lem, and it occurs in any system which allows interrupt processing. It is solved 
in different ways. Most simply, common subroutines can be forbidden. Alternatively, 
push-down stacks are utilized, scratch storage is forbidden, (except in the stack), 
and-the programming task is made significantly more imposing. 

RTX has implemented an alternative solution to this problem, that of a “shared** 
facility. In our context a shared facility is a body of code which may be called 
coi^ urrently from more than one task. In this sense, a shared facility is then 
coj^n to several tasks. 

Th(. implementation consists of two services which are contained in RTX. These are: 

SUBR: To initiate the execution of a shared facility 

SUBX: To return from a shared facility 

To illustrate usage of these services, consider the following example. If the 
subroutine CUP is a common subroutine to two tasks (named COFFEE and TEA) , then it is 
possible that an interrupt could occur which causes task COFFEE to execute before 
task TEA Finished. This means that subroutine CUP could be entered from COFFEE 
before it completed the processing due to its prior entry from TEA. In this case, 
subroutine CUP is in common usage . It is designated as a shared facility and must be 
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C ^esigned bo accomodate that condition. The method here is to use the following 
sequence of code in both COFFEE and TEA whenever it is desired to call subrout ine 

CUP t 

I 

JST SUBRs ACTUALLY CALL SUBR: SERVICE 

DATA CUP NAME OF COMMON SUBROUTINE 


instead of the usual method 

JST CUP 



I E3QTB I 

NEVER call a common subroutine directly; that is, with a JST name. 
ALWAYS call a common subroutine using 

JST SUBR: CALL THE SUBR: SERVICE 

DATA NAME NAME pF COMMON SUBROUTINE* 

(or using the LOCK: or PROT: routines described below). 


3.6 WRITING COMMON SUBROUTINES 

The rules for writing a common subroutine are very simple. They apply to the sub¬ 
routine exit instruction. There are two rules: 



Instead of the traditional RTN instruction, use a JMP to the location directly 
before the subroutine entry point. 


2. In the location directly before the subroutine entry point, place a JST SUBX:. 


Use of these two rules will allow an orderly exit from the common subroutine. In our 
previous example, subroutine CUP looks like this: 


fa 

( 


NAM 

CUP 

EXTR 

SUBX: 

JST 

SUBX: 

ENT 


JMP 

CUP-1 


ENTRY TO COMMON ROUTINE CUP 
EXIT COMMON ROUTINE 


When SUBR: and SUBX: are used, all subsequent calls to the common subroutine are 
•'locked out" until the current call to the subroutine has completed and the jump to 
SUBX: has been made. Then, each subsequent call (made while the common subroutine was 
busy) is completed in priority order. 

If this procedure is not followed, the system behavior will appear to be very erratic 
Although the system will probably correct itself, when the doubly-returned task 
finally terminates, one activity has been lost, and one has been duplicated, probably 
incorrectly. If the user understands this section thoroughly, he can have the con¬ 
venience of library subroutines, without the difficulty of accidental re-entry. 
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3.(~ CALL A COMMON SUBROUTINE (SUBR:) 

This subroutine is called by a user task to schedule a subroutine which may 
I be used by more than one task. 

| f 

This subroutine does not return directly to the calling program. It 
exits through the Scheduler (SCHED:). 

Calling Sequence: 


ESOTE 


JST SUBR: 

DATA (*) ADDRESS OF COMMON SUBROUTINE 

Enters Subroutine With: 

INTERRUPTS—ENABLED 

STATUS-UNCHANGED 

A REGISTER-UNCHANGED 

X REGISTER-UNCHANGED 



The return address put in the entry point of the common subroutine is 
, the location following the data in the above call. That is, it 
appears to the subroutine as if it were called from the location of 
its address (Not the location of the "JST SUBR:"). 


3.8. EXIT FROM COMMON SUBROUTINE (SUBX v :) 


This subroutine is called from within a common subroutine to return to the calling 
:ask. 



( 


MOTS 


This subroutine does not return directly to the calling program. It 
exits through the Scheduler (SCHED:). 


Calling Sequence 

JST 

SUB ENT 

JMP 


SUBX: 

where: SUB is the entry point of the common 

subroutine. This call must immediately 
precede the entry so that RTX can keep 
its chains straight. 

SUB-1 RETURN 
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Returns to calling task with: 

INTERRUPTS—ENABLED 

STATUS-UNCHANGED 

A REGISTER-UNCHANGED 

X REGISTER UNCHANGED 


Each SUBR: call made must have a corresponding call made to SUBX: once 
the routine has completed. If a call to END: (to terminate the calling 
task) is made from within a subroutine called by SUBR:, all other tasks 
will be permanently denied the user of that routine. To terminate a task 
from within a SUBR'd subroutine, the ABORT: routine should be used. 


3.9 PROTECT A FACILITY (PROT:) 

PROT: is called by a user's subroutine to protect itself from usage by other tasks. 

It is in a way similar to SUBR: in that reentrance to a common subroutine is prevented 

during its usage? however, in SUBR:, the determination to protect the subroutine is 
made by the calling program , while in PROT:, the determination is made by the sub¬ 
routine itself. 

Calling sequence: 

DATA 0 

SUB ENT 

JST PROT: 

DATA $-3 

The call to PROT: must be the first instruction following the entry point. The temp 
cell SUB-1 is used by PROT: to store the contents of SUB (the return address from the 

caller) . Note that exiting from the routine SUB must be done via the return address 

in SUB-1, not the address in SUB. 

Returns with: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A-REGISTER—“UNCHANGED 
X-REGISTER-UNCHANGED 

PROT: may be called more than once using the same coordination number by the same 
task. However, a different task is effectively locked out of the subroutine until it 
is released by executing a call to UNPR:. 
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fr 

C 


The INTRS: and INTQ: subroutines contain logic to preclude task¬ 
switching caused by an interrupt occuring immediately before a JST 
LOCK: or JST PROT: instruction. This involves checking the inter¬ 
rupted instruction to see if it is a JST LOCK: or JST PROT:. This 
check is effective only if the instruction is a JST indirect through 
a base page pointer to LOCK: or PROT:; that is, an :F9xx instruction. 
To insure this protection feature, reference LOCK: or PROT: by means 
of an EXTR directive, rather than a REF directive. This also implies 
that if EXTR directives are used in conjunction with the LPOOL 
directive, then an EXTR LOCK: or EXTR PROT: must be accompanied by a 
SPAD LOCK: or SPAD PROT: directive to insure that the pointer remains 
in the base page. 


EiOTE 



RELEASE A PROTECTED FACILITY (UNPR: ) * 


UL..-C: is called by a common subroutine to delete its protected condition caused by a 
previous call to PROT: 


Calling Sequence: 



JST UNPR: 

DATA Coordination Number 


Returns with: 

(' 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A-REGISTER-UNCHANGED 

X-REGISTER-UNCHANGED 


Ini^ffect/ RTX treats the address of a common subroutine (as used in SUBR: and SUBX:) 
asTf coordination number. These are shared with the coordination numbers used by 
P: and UNPR:. That is, the list in which the common subroutine addresses are 
saved for SUBR: is the same list that saves the coordination numbers for PROT: and 
LOCK:. Results will be unpredictable (and probably disastrous) if the coordination 
number used by PROT:, UNPR:, LOCK: or UNLK: is also the address of a common subroutine 
(called by SUBR:). 

Because RTX maintains a single list for PROT: and LOCK: coordination numbers and 
SUBR: common subroutine addresses, an alternative method for writing common sub¬ 
routines exists. The rules for this type of common subroutine are: 


1. Instead of the standard "RTN SUB” instruction, use a "JMP SUB-2". 

2 . In the 2 locations directly before the subroutine entry point, place: 




JST 

RES 


SUBX: 
1 
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In the two locations immediately following the subroutine entry point, place: 


JST 

DATA 


PROT: 

SUB-1 


Because PROT: moves the return address from SUB to SUB-1, references to parameters 
must be made through SUB-1 # rather than SUB. For example, a typical routine, 
that adds the arguments presented to it and returns the sum in the A register, 
would normally be coded as follows: 

Calling Sequence: 


ADDM 


JST 

ADDM 

DATA 

3 

DATA 

4 

ENT 


LDA 

*ADDM 

IMS 

ADDM ' 

ADD 

*ADDM 

IMS 

ADDM 

RTN 

ADDM 


I E§<DT5 I 

This may not be used as a common subroutine because it has no 
protection from re-entrance. 

Using the SUBR: common subroutine feature, the routine would appear as follows: 
Calling Sequence: 


JST 

DATA 

DATA 

DATA 


ADDM 


SUBR: 

ADDM 

3 

4 

SUBX: 

♦ADDM 

ADDM 

*ADDM 

ADDM 

ADDM-1 


1 / 3-9 






Com puter Automation 


'ljte alternative method, using the PROT: common subroutine feature, is as follows: 
V 

Calling Sequence: 


ADDM 


JST 

ADDM 

DATA 

3 

DATA 

4 

JST 

SUBX: 

RES 

1 

ENT 


JST 

PROT: 

DATA 

ADDM-1 

LDA 

*ADDM-1 

IMS 

ADDM-1 

ADD 

*ADDM-1 

IMS 

ADDM-1 

JMP 

ADDM-2 


^ dvanta 9 es of' the last example, using the PROT:/SUBX: sequence, are: 

1 i The calling sequence is shorter than that calling SUBR: (the standard JST SUB is 
used). 

2. The burden for insuring that the subroutine is common (re-entrance protected) 
lies solely with the subroutine writer, not the subroutine caller. 

3. If the subroutine is capable of stacking multiple return addresses (not shown in 
f this example), the subroutine is then recursive, and may call itself. (Note that 
^ if recursive, SUBX: should only be called on the last return (use RTN SUB-1 for 

( all returns but the last)). 


3.11 LOCK OUT A FACILITY (LOCK:) 


LOCK: was designed for use by Real Time FORTRAN, and is similar to PROT:. The only 
difference between them is that the return address from the subroutine is stored in 
thij^location following the coordination number, instead of the location in front of 
th®i&ntry point, e.g.: . 


Calling Sequence: 
SUB 


ENT 

JST 

DATA 

DATA 


LOCK: 

Coordination Number 

0 4 (Return address stored here) 


Returns With: 


INTERRUPTS-ENABLED 

STATUS-—UNCHANGED 
A-REGISTER-UNCHANGED 

X-REGXSTER-UNCHANGED 


The JST to LOCK: does not need to be placed immediately following the subroutine entry 
p<Q^ t, although JST to PROT: does. 
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The user should reference the LOCK: or PROT: subroutine with an EXTR directive, 
rather than a REF directive. See the note in the PROT: description regarding this. 

Note that the PROT:/SUBX: example shown above does not apply to LOCK:. 


3.12 UNLOCK A LOCKED FACILITY (UNLK:) 

UNLK: is similar to UNPR:. However, UNLK: permits the common subroutine to complete 
processing, then returns control to the calling task, while UNPR: returns through the 
Scheduler to the Ready list for the next task on the list. 

3.13 ABORT A TASK (ABORT:) 

ABORT; is called from within a common subroutine to terminate the task which called 
the subroutine. 

In addition to performing the END: function, J ABORT: also deletes any PROT:, LOCK: or 
^SUBR: conditions previously set by the aborted task. 

Calling Sequence: 

JST ABORT: 

ABORT: exits to the scheduler (SCHED:). 


MOTS 


The duration of an ABORT: call is significantly longer than an END: 
call, and therefore it should be called only if in a common subroutine, 
or in a PROTected or LOCKed condition. 


3.14 OBTAIN CURRENT PRIORITY (GETPR:) 

Calling Sequence: 

JST GETPR: 

Returns With: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A REGISTER CONTAINS TASK PRIORITY 
X REGISTER-*-—UNCHANGED 

The subroutine is called to get the current priority of a task. It is usually 
called so that a task’s priority may be restored after it is temporarily altered. 
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LDA DESIRED PRIORITY 

JST SETPR: 

Returns With: 


INTERRUPTS-ENABLED 

STATUS-OV RESET, WORD MODE 

A REGISTER UNCHANGED 

X REGISTER UNCHANGED 


This subroutine is called whenever a task desires to alter its priority. 


3.16 INCREMENT TASK PRIORITY (INCPR:) 
Calling Sequence: 

JST INCPR: 


Returns With: 


» 


INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

f A REGISTER UNCHANGED 

^ X REGISTER UNCHANGED 

T s subroutine will increment the priority of the calling task by 1. No range 
checking is performed. 


3.17 DECREMENT TASK PRIORITY (DECPR:) 



Calling Sequence: 
JST 


Returns With; 


DECPR: 


INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A REGISTER UNCHANGED 

X REGISTER UNCHANGED 


This subroutine will decrement the calling task's priority by 1. No range checking 
is performed. ,! 



I 
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additional rtx features 


4.1 RTX DEBUG FEATURE (ZBG) 

The standard CAI DEBUG program is included in the RTX library tape (Segment. 1) under 
the name ZBG. (Detailed descriptions of DEBUG are included in LSI-2 AutoMagic, CA 
document 96045-00, or LSI-3/05 AutoMagic, CA document 93001-00). When this module is 
linked. Relocation Register RF points to the RTX Linked list pointers for use with Z 
function* the corresponding length required by the Z function is set to five words, 

V hich is the length of each block used in the RTX Linked lists. When displaying a 
fiFJparticular list with the Z function, the first printed line is not an entry in the 
*JList, but simply the pointer to the top of the list, followed by the next four higher 
^ words in memory; this first line may therefore be ignored. 

• There are eight lists maintained by RTX, and the pointers to the top of • each of these 
j lists reside within the RTX nucleus in eight consecutive memory locations, in the 
following order: 


i 


0RF 

Pointer 

to 

the 

list 

of 

1RF 

Pointer 

to 

the 

list 

of 

2RF 

Pointer 

(DLYCH) 

to 

the 

list 

of 

3RF 

Pointer 

to 

the 

list 

of 

4RF 

Pointer 

to 

the 

list 

of 

5RF 

Pointer 

to 

the 

list 

of 


GET: (GETCH) 



6RF 

Pointer 

to 

the 

list 

of 

7RF 

Pointer 

to 

the 

list 

of 


(IOCH) 


(PUTCH) 


(FREE) 


r The following is a description of the contents and manipulation of a user block 
within each of the lists: 




READY List (RF) Ready to Run (used by BEGIN:) 

RTX maintains a list of all tasks which are ready to execute in the READY list. 
This list is sorted into priority order, so that RTX simply executes the task 
at the top of the list. The format for a READY block is as follows: 


Word 

0 

1 


Contents 

Word address pointer to next block entry in the list. (The last 
element in the list.contains a zero). 

Bits 15-3. Task priority number. 

Bits 2-0. (LSI-2 only) 

Bit 2. EIN indicator, for reference only. (RTX always 
allows interrupts.) 

Bit 1. BYTE mode indicator upon next resumption of task. ' 
Bit 0. Overflow indicator upon next resumption of task. 
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Word Contents 


2 

3 

4 

FIFO list (1RF) Ready to Run (used by INTAC: and INTQ:) 

In order to avoid the problems of interrupting a linked list processor, INTQ? 
and INTAC: put the entries for their tasks in the FIFO list. (BEGIN: operates 
directly on the READY list). The RTX scheduler (which is never run as an 
interrupt routine) empties the FIFO list into the READY list and sorts the 
READY list. The format of a FIFO block is the same as a READY block. 

DLYCH List (2RF) Delay (used by DELAY:) 

A call to DELAY: (with a unique positive coordination number) causes the block 
for the currently executing task to be deleted from the READY list and put on top 
of the DLYCH list. The format of a DLYCH block is as follows: 

Word Contents 

0 
1 
2 

3 

4 

Upon return, the A register will contain the coordination number. The X register 
will contain the number of Real Time Clock "ticks" remaining (normally zero). 

COMN List (3RF) Common Subroutine (used by SUBR:, SUBX:, LOCK:, UNLK:, PROT:, 
UNPR:) 

A call to SUBR:, LOCK: or PROT: causes the COMN list to be searched for a block 
for the common subroutine. If none is found, a block is deleted from the FREE 
list and put on top of the COMN list. The format for a COMN block is as follows: 

Word Contents 

0 Pointer to the next block in the list 

1 Busy flag (zero = not busy) 

2 Pointer to the block of the highest priority task waiting to use 
the common subroutine (0 = no task waiting) 

3 Address of the common subtoutine (or coordination number) 

4 Unused 

If SUBR: is called and a block for the common subroutine is found with the Busy 
flag set, the block for the currently executing task is deleted from the READY 
list, and inserted into a secondary list pointed to by Word 2 above. At the same 
time, the P register is set so that the task will again call SUBR: when RTX next 
executes the task. 


Word address pointer to next block in the list. 

Status & Priority. Same as READY list entry. 

The P register. Points to address of return from DELAY: 
The coordination number. 

Working number of ticks left in Delay. 


Bits 2-0. (LSI-3/05 only) 

Bit 2. BYTE mode indicator upon next resumption of task. 
Bit 1. Overflow indicator upon next resumption of task. 
Bit 0. Unused 

P register contents upon next resumption of task. 

A register contents upon next resumption of task. 

X register contents upon next resumption of task. 
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IOCH List (4RF) I/O Suspend (used by IOX:, Fortran Interface) 

A call to IO: or IOWAT: when the busy flag is set in the IOB, or a Fortran call' 
for I/O when no parameter block is currently available, will cause the task block 
to be deleted from the READY list and put on the top of the IOCH list. The P 
register is set so the task will repeat the call when RTX next executes the task. 
The format of an IOCH block is the same as for a READY block. The IOCH list is 
emptied into the READY list each time any I/O completes. 

GETCH List (5RF) Get (used by GET:) 

A call to GET: with a unique positive coordination number (and no matching PUT: 
yet) causes the block for the currently executing task to be deleted from the 
READY list and put on top of the GETCH list. 

Word Contents 

Pointer to next block in the list 
Status & Priority (same as Ready) 

P register. Points to return from GET: 

Coordination No. 

Unused 

When the associated PUT: is done, the block is deleted from the GETCH list, the 
A and X register contents are stored into words 3 and 4, and the block is inserted 
into the READY list in priority order. 

PUTCH List (6RF) Put (used by PUT:) 

A call to PUT with a unique positive coordination number (and no waiting GET:) 
causes a block to be deleted from the FREE list (see below) and added to the top 
of the PUTCH list. The format for a PUTCH block is as follows: 

! 

Word Contents 

0 Pointer to next block in the list I 

1 Unused } 

2 A register contents to be passed - ; 

3 Coordination No. 

4 X register contents to be passed 

When the associated GET is processed, the block is deleted from the PUTCH list 
and put on top of the FREE list. 

FREE List (7RF) Available Storage 

This list is initialized to contain the entire work space during a call to RTX:. 

As blocks are required, they are taken from the top of the FREE list. As blocks 
are no longer required, they are deleted from the appropriate list and put onto 
the tail of the FREE list. A FREE block has no specific format. It will simply 
contain data from the function which last used the block. 


0 

1 

2 

3 

4 
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Is 4.(T I'KOGKAM l.OADING with zbg 

l! 

ZBG resides in the RTX library; to make use of ZBG, it is necessary to include a 

fi 

i * 

ZBG REF 

: ( 

instruction within the user's program- Thus ZBG is entered immediately upon execu¬ 
tion, and may then be used to breakpoint through the mainline sequence and any parti¬ 
cular task. 



4.3 POWER-FAIL, AUTO-RESTART (PWRFL:) 

If the computer being used has the Power Fail option, the user may utilize the RTX 
program module which provides service for that device. The loader will cause the 
routine to be loaded if the user has a REF to PWRFL: . He must, however, not actually 
call that program at execution time. Instead, if a power failure begins, the inter¬ 
rupt hardware will force control into that routine, saving the computer's register 
st^is, and halt, to prevent loss of information 'from core storage. When the power 
is(^*stored, the program will schedule a user-supplied routine, which must be named 
P" UP:, and must occur in a NAM directive. Re-initiation of the activity which was 
iu process (at the time of the power failure) will also be scheduled and control 
will be passed to the system Scheduler. 

RTX will schedule PWRUP: as a task at priority 8184 with the contents of the A 
register nonzero if the power failure was detected. If power failure was not detected 
(e.g., the computer was halted), RTX will transfer control to PWRUP: with the 
co^ nts of the A register equal to zero. Note that RTX cannot resume the activity 
in progress at the time of the power failure if the powei. failure was not detected. 

4\ TELETYPE 1NPUT/0UTPUT 

RTX provides decimal, octal, and hexadecimal I/O on the standard Teletype, by using a 
software interface to CAI's Teletype Utility Package (TUP). The ra!h- and usage are 
identical to the standard version. 

TUr -Iso provides the capability to read and print strings of text, (for headings, 
lc^»|is, etc.), and this capability is retained in the RTX version. 

R( :r to the standard TUP documentation ■(* 36014) for a complete description of each 
routine. Additionally, a specific limitation exists with respect to TUP usage through 
RTX:. TUP must not be called concurrently by more than one task, because TUP itself 
- calls subroutines within it with JST instructions, and these subroutines are not 
protected from re-entrance. 

TUP re:ides on the RTX Segment 2 library tape, and its routines should be referenced 
with the REF or EXTR directive. 


4.5 LSI-3/05 SOFTWARE CONSOLE ROUTINE (CNS0L3) 

The LSI-3/05 version of RTX includes CNS0L3, the Sofeware Console Routine, which may 
be linked by a reference to CNS0L3 in the user program module. Usage of the Software 
Console Routine is described in the LSI-3/05 Software Manual (90-20010-00) 

<t 
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RTX OPERATING PROCEDURES 


Assemble each of your application program modules. Be sure to reference each RTX 
function that a module uses in either an EXTR or a REF directive. 

When you have a useful object tape for each of your modules / you are ready to 
create the executable application program. This requires that you first load 
LAMBDA, the relocating, linking loader. 

Using LAMBDA, force load the initializer task module of your application. 

j 

Then using LAMBDA, load the remainder of your group of application program 
modules. You can use the Selective Load feature of LAMBDA to include only the 
modules your program actually requires. 

Still using LAMBDA, selectively load the RTX Library object modules from the two 
RTX Library Tapes (70-93300-01 and 70-93300-02). 


MOTE 


If the user program does not reference PROT: and LOCK:, LAMBDA and 
OS:LNK will declare these subroutines as undefined. This declaration 
can be ignored since INTRS: and INTQ: (loaded after PROT: and LOCK:) 
check to see if a call to either subroutine is the next instruction 
after an interrupt is serviced. 


MOTE 


When operating under the I OX File Manager, disk devices must be 
labeled prior to their use. Labeling is done with the stand¬ 
alone program, RTX File Label Utility (tape Nos. 70-93324-40A1 
and -41A1). Subsection II/5.3 gives a complete description of 
this utility. 

Start execution of your program so that the initializer module (Mainline Sequence) 
or ZBG, if used, is executed first. • 
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A SAMPLE RTX PROGRAM - RTX DEMO 


6.1 PROGRAM DESCRIPTION 

The RTX Demo Program (00-93300-13) demonstrates the basic functions of RTX in a 
simple, straightforward manner. It consists of three main tasks (TASKl, TASK2, 
TASK3). The function of each of these tasks is to delay a specific amount of time, 
and then call a routine to output a message to the teletype. The message consists of 
the task name followed by the elapsed time in seconds since the start of the program. 


An actual user's application of RTX might very well use the interrupt from some 
lixternal device to initiate a task. This example simulates the effect of three such 
devices which interrupt every 5, 7, and 11 seconds, respectively; that is, the delays 
themselves simulate external devices. 


Each task delays a different amount of time than the other tasks, before printing, 

TASKl delay: 5 seconds 

TASK2 delay: 7 seconds 

TASK3 delay: 11 seconds 

Thus TASKl will output 

"TASKl 0005" 

"TASKl 0010" 

"TASKl 0015" 


TASK2 will output 

"TASK2 0007" 
"TASK2 0014" 
"TASK2 0021" 
etc. 

And TASK3 will output 


- "TASK3 0011" 

"TASK3 0022" 

."TASK3 0033" 
etc. 

Because of teletype timing, each message takes more than one second to complete. 
Thus the three tasks will contend with each other for the use of the teletype. 
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iQ addition, a fourth task called "IOTASK” outputs the actual teletype messages. This 
task is begun by each of the three main tasks whenever their delays expire, at the 
following various priorities: 

TASKl begins IOTASK at priority 5 
( TASK2 begins IOTASK at priority 7 
TASK3 begins IOTASK at priority 11 

This means that if TASKl and TASK3 both begin IOTASK at the same time (which they 
will, at 55 seconds), TASK3's message will be output first, since its priority to 
begin IOTASK is higher than TASKl's. 

To be more specific, and to demonstrate the priority sequence more fully, the actual 
teletype output after 55 seconds appears as: 

TASK3 0055, TASK2 0056, TASKl 0055,... because each message takes slightly more than 
one second to print, thus causing the following sequence: 

f TIME ACTION , 

55 seconds after start TASKl and TASK3 both begin IOTASK with a "55 seconds'* 

message. Since TASK3 has the higher priority, its 
message is printed first. 

TASK2 begins IOTASK with a '*56 seconds” message. 
TASKS's ”55 seconds'* message is still printing, and 
TASKl's ”55 seconds message” is queued up. Since 
TASK2 has a higher priority than TASKl, the TASK2 ”56 
seconds” message gets output when TASK3’s message 
completes. 

r 57+ seconds after start TASKl's ”55 seconds” message is output after TASK2's 

v ”56 seconds” message is completed. 

After 80 seconds, the teletype listing should appear as: 

TASKl 0005, TASK2 0007, TASKl 0010, TASK3 0011 
TASK2 0014, TASKl 0015, TASKl 0020, TASK2 0021, TASK3 0022 
TASKl 0025, TASK2 0028, TASKl 0030, TASK3 0033 

TASK2 0035, TASKl 0035, TASKl 0040, TASK2 0042, TASK3 0044 

TASKl 0045, TASK2 0049, TASKl 0050, TASK3 0055 

TASK2 0056, TASKl 0055, TASKl 0060, TASK2 0063, TASKl, 0065, TASK3 0066 

TASK2 0070, TASKl 0070, TASKl 0075, TASKS 0077 

TASK2 0077, TASKl 0080, 

(TASK3's message contains carriage return and line feed control characters). 



56 seconds after start 

Cr» 


6.2 PROGRAM MODULE FUNCTIONS 

Let us now examine the RTX functions used in this program (refer to the flowchart in 
figure 6-1 and the program listing at the end of this section). There are six basic 
modules comprising the program: 

TASK3 
IOTASK 

ADD! 
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q. 0.2.1 0126IN (Initialize anil Beyin Task:;) 

The program start occurs at the BEGIN section of the flowchart. The first step is to 
initialize RTX. This is performed using the RTX: function to define the maximum 
number of RTX tasks which may be in concurrent operation and the required table space 
for RTX management of those tasks. If insuffic:jout table space is found or other 
v peculiarities occur during initialization, the error return is taken. In our example, 
we halt the computer to remedy the problem. Using the BEGIN: function of RTX defines 
the task name (TASKl, TASK2 and TASK3 in our example) and its software priority 
number (100 for each in our example). 

No other tasks have begun their activity at this point. This is because the first 
task following the RTX: call (the initialization sequence itself) is automatically 
scheduled at the highest software priority. When the END: function is called, this - 
task is deleted and the Scheduler can then schedule the other tasks in relation to 
their priority. . . 

Since the three tasks all have priority 100 and priority 100 is the highest active 
J priority value, the Scheduler will arrange each task in sequence according to the 

order in which it was initiated by the BEGIN: call, and will then start execution of 
W the first task in that sequence. The sequence is determined by a first-in, first-out 
rule. Therefore, TASKl executes until it requests an RTX service which causes it to 
be suspended. 

When the task is re-scheduled (on completion of one of the above function calls) , it 
is put back in sequence at the end of all other equal priority tasks. 



This type of organization allows for true priority scheduling within an application, 
while also allowing the tasks themselves to be executed, interrupted, and resumed in 
an orderly fashion. 


6.2.2 TASKl (Delay 5 seconds. Then Output Name and Elapsed Time) 



When TASKl is begun, it first performs a five second delay. This is done by a call 
to DELAY: with parameters of 500 (number of .i0 millisecond real time clock “ticks** to 
delay) and 1 (a specific coordination number for this particular task's delay calls). 
The coordination number is necessary mainly for identifying a delay to be changed or 
deleted; however, it is also required when beginning a new delay, as in this example. 
When the delay is completed, control is returned to TASKl, which then calls the 
subroutine ADD1, which increments the elapsed time in the TASKl message by five 
seconds. Note that ADD1 is called via SUBR: , because it is a common subroutine used 
by all three tasks, and is not re-entrant; thus SUBR: prevents another task from 
entering ADDl until this call is completed. 


Upon return from ADDl, the mess.».;e is ready for output to the teletype. This is done 
by a call to BEGIN: to initialize the common task called "IOTASK," which in turn 
makes the actual call to the I/O executive (I0X) to perform the output. Note that 
"IOTASK" is a task, not a subroutine; this means that TASKl may now continue with its 
next 5-second delay while the I/O is in progress rather than upon its completion, 
which would invalidate the elapsed time count. Also, the initiation of the common 
task is made with a priority of 5. IOTASK is also initiated by TASK2 and TASK3, with 
priorities of 7 and 11 respectively, so that a predictable ordering of outputs is 
achieved when two or three tasks are vying for the teletype at the same time. 
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6.2.3 TASK2 (Delay 7 Seconds, Then Output Name and Elapsed Time) 

TASK2 is identical to TASK1 in its logical functioning. The only difference between 
them is in the parameters passed in their calls to DELAY:, ADDl, and IOTASK. TASK2 
ca ^ DELAY: with a 7 second count and a coordination number of 2 (to differentiate 
it irom TASKl *s delay call). The common subroutine ADDl is called to increment the 
elapsed time by seven instead of five, and the common task IOTASK is begun at a 
higher priority (7). 


6*2.4 TASK3 (Delay 11 Seconds, Then Output Name and Elapsed Time) 

TASK3 is similar to TASKl and TASK2. TASK3 calls DELAY: with an 11 second count and 
a coordination number of 3. It calls ADDl to increment the count by eleven, and 
begins IOTASK at priority 11. 


6.2- 5 IOTASK (Call IOX To Output A Message Ori The Teletype) 

IcWlsK is a common task begun as a task by BEGIN: calls in TASKl, TASK2 and TASK3. 

Up* )entry, the X register contains an address pointer to the I/O Information Block 
(IOB) of the calling task. A call is then made to the IOX package (at its entry 
point named IO:) passing the IOB address as a parameter. An error status from the 
I/O operation will cause the computer to halt. Otherwise, the task terminates itself 
with a call to END:. 


6.A^ ADDl (Common Subroutine To Increment The Elapsed Time for Printing) 

ADD is a common subroutine called by TASKl, TASK2 and TASK3 prior to printing their 
messages. Upon entry, the A register contains the amount by which to increment the 
elapsed time tally, which is pointed to by an address in the X register. The routine 
performs the addition, and then returns to the calling task through SUBX:. This is 
because the subroutine was called via SUBR: to avoid re-entrance. 
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Figure 6-1. RTX Demo Program - Flow Diagram {Sheet 1) 
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Figure 6-1. RTX Demo Program - Flow Diagram (Cont’d) 
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\ IOX GENERAL DESCRIPTION 


IOX is a subsystem of RTX which operates under RTX control, and provides the user with 
a complete, modular method of input/output device management and support., Application 
programming is faster since time-consuming input/output programming for standard 
peripherals and communications devices need no longer be done by the user. Since IOX 
is open-ended, the user can add capability for virtually any kind of device unique, to 
his application and program it under IOX control. All I/O performed by IOX is 
interrupt-driven and allows other tasks in the system to execute even though I/O is in 
r progress. 


jwWorking in conjunction with IOX is the File Manager that enables the user to communi- 
cate with data files by name, independent of the physical medium storing the file. 
Requests for file access are made through IOX using Logical Units (LUNs) . 


IOX can perform one operation at a time for each peripheral device. Operations 
requiring the use of the same device are done in I/O task priority order (i.e., the 
highest priority request is honored whenever the device is available to be used). 
r Operations performed on different devices are done concurrently. All calls to IOX 
specify a Logical Unit (LUN) on which to perform the I/O rather than physical units. 
This feature allows a program to be debugged using one set of I/O assignments and 
executed using another. 


IOX satisfies the following I/O requirements of the system: 


1. Selects the proper commands for communicating with external devices. 



Processes device interrupts in the following manner: 

a. Saves the status of the currently executing task. 

b. Determines the task priority of the interrupt. {Must it be serviced immedi- ; 

ately or can it wait for the completion of a higher priority task and if so, 
is the higher priority task ready for execution?) ' 


c. Determines whether the task processing the interrupt is a re-entrant task, or 
that the interrupt may r ot be serviced until each prior interrupt has been 
fully processed. 


» 


d. Determines which of the I/O tasks awaiting execution has the highest 
priority, then restores the CPU status to the environment of that highest 
priority and gives control to that task. 

e. Ensures that no task may access a device while it is controlled (dedicated) 

by another task. . . 

f. Ensures that the interrupt system is not disabled for a period of time which 
would prevent a high speed device from performing I/O successfully. 
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Because of the likelihood of having several similar devices attached to the computer 
. (deluding identical units) in a real time environment, IOX has been designed to make 
i easy to support several similar devices (differing only by device address) using 
"shareable" code. IOX requires some space for flags, device addresses, etc. Since 
the types of flags depend on the device, as well as the interface to which the device 
is connected (there may be more than one device per controller), IOX maintains flags 
in two separate locations depending on whether the information is unique to the 
device or to the controller. In order to utilize the minimum space in memory for 
these flags and temporary cells, and to facilitate the allocation of these cells, IOX . 
does most of its interfacing by means of tables which define the type of device and 
.interface to which it is connected. 

IOX is primarily concerned with four tables: 


\( 


I OB 
UAT 
DIB 
CIB 


Input Output Block 
Unit Assignment Table 
Device Information Block 
Controller Information Block 



(These tables are more fully described in section 2 (IOB and UAT) and section 4 (DIB 
and CIB) . The IOB is created by the user (task) and resides within the calling task. 
It contains the Logical Unit Name or Number (LUN) as well as specifications for the 
I/O operation to be performed. 


UAT is also created by the user. It is a series of two-word entries, each of 
which equates the LUN (specified in the IOB) to a specific device. 


*1. - DIB anc * are tables which are used in communication between IOX and a parti¬ 

cular handler. IOX contains within it DIB's and CIB's for each standard device. 
Additionally, the user may create his own tables if he desires; for example, he may 
reserve an extent on a disk by specifying its boundaries in his own disk DIB, or he 
may create a DIB and CIB (and a handler) for a non-standard device. 


if jeneral, the usage of these tables by IOX is as follows: The user constructs the 
within his program and calls IOX, giving as the sole argument the address of this 
Jrvk. IOX must then transfer control to the handler associated with this request- To 
l so, it first obtains the logical unit number (LUN) from within the IOB, and com¬ 
pares it to each entry in the UAT until a match is found. The UAT is simply a list 
of each possible Logical Unit Name/Number (LUN) , associated with the address of the 
DIB which defines the device assigned to that LUN. Thus for each IXJN the UAT contains 
a pointer to the appropriate DIB. In turn, each DIB contains a pointer to the CIB 
which defines the interface to which the device is connected. Finally, the CIB 
contains a jump table which points to the particular handlers (procedures) for pro¬ 
cessing the specific request. Therefore, given an IOB and a UAT, IOX can find the 
procedure to handle the request made in the IOB. 

The following steps are performed during a normal call from the user to IOX: 

1. The user calls IOX carrying the word address (may be indirect) of his IOB. 


c 


IOX examines the status within the IOB. If the IOB is busy (from a previous call 

to IOX), the calling task is suspended and control is passed to the RTX task 
scheduler. 


TT /I 
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If the IOB is not busy, it is then flagged as busy, and the UAT is searched to 

find a LUN which matches the LUN in tji^ IpB. If not found, an abnormal return is*| 

made to the caller after setting the "Invalid *LUN ,f status- bit i n th e~ ; t OB : 11 -——-? 

If a matching UAT entry is found, the correct DIB is located (the DIB is refer¬ 
enced within the UAT entry) and the requested function code is compared to the * ^ 
permissible function code(s) within thfc.PjEB.’ If the requested function code is 
found to be illegal, an abnormal—returned s-^made- to L the—caller-after- s et t in g— th e " -—j 
"Error" status bit .in the IOB. J '/ ■ • : • • <.i>* i.sron i to complete."- ' >*■ 

.. .. ,’!i i 

IOX next queues the I/O request with any previously pending I/O requests for the 
requested device according to the priority of the calling task and passes control 
to its internal I/O scheduling routine. 

The scheduling routine then monitors the request queue in each DIB; whenever it 
becomes physically possible to begin an I/O request (the I/O device is available 
and no higher priority request is pending), the scheduler calls the appropriate 
I/O handler routine (driver) according to the handler entry address within the 
CIB. 

» 

In general, the I/O handler routine will set up the required interrupt locations, 
select the device, and initiate a watchdog timer, and then return control to the 
I/O scheduler. 

The I/O scheduler continues monitoring the I/O request queues and calling the 
applicable I/O handler routine(s) until each DIB has been examined qnce. Then 
the I/O scheduler terminates with a call to END:. 


j. When an end-of-block I/O interrupt occurs, it causes a return to the I/O handler 
which initiated the I/O operation. The handler will normally at this time, call 
an end-of-block routine within IOX, which stores the I/O status and record count 
into the IOB, releases the device from dedication (if desired), returns to the 
calling task through either the normal or the abnormal return location, depending 
on the status, and begins the I/O scheduler. 

10. If an I/O error should cause the watchdog timer to expire prior to I/O completion, 
it causes a return to the applicable handler, which will then normally execute an 
initialize function to the device, store an "Unresponsive Device” status into the 
IOB and return to the caller’s abnormal return location. 


1.2 CALLING SEQUENCES 


The three entry points to IOX are: 

IO: To perform an I/O operation or special function 

IOREL: To release a dedicated device 

I0WAT: To wait for completion of an I/O operation 
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of these entries requires a parameter list (IOB). IOB format is described in 


et\-.l in section 2. The IOB specifies the type and mode of operation, data area, 
ata length, and the Logical Unit Name/Number. It also provides room for status 
nformation to be returned to the calling task. All calls to IOX return with the 
egister3 as follows: 


A Register 
X Register 
OV Register 
Word Mode 

LSI Console Data Register 


Undefined 

Pointing to the IOB 
Undefined 

Unchanged 


fie format of a call to IOX to perform an I/O operation is: 


JST 10: Call the IOX perform I/O routine 

DATA (*)I0B Address of the Input/Output Block 

• - Immediate Return 

-—• Operation complete-abnormal return 

■- Operation complete-normal return • . 

c 

ot^pbhat there are three exits from 10: — two are always taken. As soon as the 
e 3st is processed, IOX BEGIN:'s a new task whose starting address is the immediate 
eturn location. When the I/O operation is completed, IOX returns to either the 
bnormal or normal return depending on the success of the operation. Having an 
mmediate exit as well as a complete exit from IOX provides the user with the option 
f concurrently executing his program while the I/O is in progress. If he does not 
ish to continue execution until the I/O has completed, he simply codes: 


n he location of the Immediate Return. 

V • I 

lternatively, if a certain amount of concurrent processing can take place during the 
/6‘operation, the immediate return location should contain a jump to the processing 
outine. When the intermediate processing has finished, and it is necessary to await 
/0 completion before continuing, a call to the XOWAT: routine is made, as in the 
ollowing example: 


JST 

DATA 


10 : 

(*)IOB 
TAG 
END: 
END: 

$ 


Initiate the I/O operation 
IOB address 

Immediate return - continue processing 
Ignore complete return 
Ignore complete return 


Concurrent processing 
during I/O 


JST 

DATA 


IOWAT: 

( *)IOB: 


Wait until I/O completion 
IOB address 

Operation complete - abnormal return 
Operation complete - normal return 


dte that a call to END: must be made at the "complete" returns from the call to 10:, 
n order to terminate the I/O task. One of these two returns will be made if I/O 
°j j/^tes before the call to ICWAT: is executed. 
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A call to 10: is equivalent to a call to BEGIN: (see chapter 1, 
RTX Functions) with a starting address of the immediate return and 
a priority of the task which calls 10 : except that the new task is 
queued before all tasks of equal priority* 

An abnormal return may result due to the following: 

LUN not in UAT 
Illegal Operation Request 
Device Error 
File Mark Input 

End-of-Device ,, ' ' 

A. normal exit will result from all other conditions. 


' *;3 DEVICE DEDICATION , 

desired, the user may dedicate a device to specific 10: calls only. Word 3 of the 
iOB provides the capability of establishing a specific (non-zero) coordination number 
for an I/O call. Once such a call has established the dedication of a device, all 
future I/O requests for that device will be held off (queued) until the device is 
released, unless they contain the established coordination number. < 

A device is released from dedication by'a call to the I0REL: subroutine, as follows: 


J ST 
DATA 


IOREL: 
(*)IOB 

Return 


On return the A register will be zero if the device was released; otherwise, one or 
more of the following A register bits will be set: 

Bit 0 set: the LUN entry in the IOB could not be found in the UAT. 

Bit 1 set: the IOB contains a coordination number of zero. • 

Bit 2 set: the coordination number in the DIB does not match the coordination 

y number in the IOB and no queued IOB has a matching coordination • - 

number. ‘ - 


1.4 LOADING 

The user is supplied with two standard relocatable object segments, each residing on 
two separate paper tapes: 

Segment 1 (paper tape 70-93300/1-01): 

This segment contains the following program modules, in the order shown: 

1. Character I/O Drivers 

2. Card Reader Drivers 

3. Magnetic Tape Drivers 

4. Disk Drivers s 
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5. I/O Scheduler 

6 . RTX Nucleus 

• 7. ZBG 

8 . CNSOL3 (if LSI-3 version) 

Segment 2 (paper tape 70-93300/1-02): 

This segment contains, in the following order: 

1. IOX Control 

2. RTX Services 

% . 

i 

In addition to these two modules, the user will require: 

L. An RTX Mainline sequence, which makes a call to RTX: to initialize the RTX envi¬ 
ronment, and to BEGIN: for each task he wishes to initiate immediately. 

2.V One or more "task" programs to be nan simultaneously under RTX (See chapter 1, 
iff|RTX Description) / 

3 [ Special device handler program (s) and the associated DIB and CIB tables, for use 
in communicating with any device(s) for which a standard handler does not cur¬ 
rently exist in IOX (see section 3, I/O Handler Organization below). These 
handler programs are not necessary if using only the standard devices (teletype, 
CRT, high speed paper tape reader and punch, line printer, card reader, magnetic 
tape, disk, floppy disk). 

C EIOTE 

( The user's special DIB's will each contain a CHAN directive to permit 

chaining to the other DIB's referenced during linking* The user 
who does not have an OS system will need version DO or higher of 
v. the OMEGA assembler in order to correctly assemble the DIB tables, 

because lower versions do not recognize the CHAN directive. 

4.*^ A Unit Assignment Table module (UAT) containing entries for each I/O unit to be 
L accessed (see section 2, UAT Description). 

T/ user may either load each module using LAMBDA, or produce a binary tape via the OS 
Li*ik Editor. The order of input of the object modules is as follows: 

1. User's main line sequence. 

2. User's various tasks. 

3. Unit Assignment Table (UAT). 

4. Special user-coded DIBs and CIBs, if any. 

5. User-coded I/O handlers, if any. 

6 . RTX/IOX tape, Segment 1. 

7. RTX/IOX tape, Segment 2. 


The RTX/IOX tapes. Segments 1 and 2, are organized in library format. Each routine on 
these tapes is loaded conditionally until the last module of the tape is read. The 
routines are organized so that only one pass through the loader is necessary. 
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Fortran tasks to be run under RTX control require additional library 
modules to be linked. Refer to the Fortran Operations Manual for a 
complete description. , 

1.5 RESTART ABILITY 

In general, if some I/O error occurs during execution for which the operator wishes to 
abort the program, it may not be restartable if the abort condition (e.g., the operator 
halts the processor through the console) occurs during the period of any I/O request 
(either pending or being serviced). This is because various "busy" flags within the 
I/O tables must be reset upon restarting the program. To insure resetting of these 
flags, reference the "IONIT:" module from the Mainline sequence (see chapter 1, 
section 2: description of the RTX: initialization routine). 
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SECTION 2 


IOB AND UAT ORGANIZATION 


The IOB (Input/Output Block) is created by the user and resides within the calling 
task. It contains the Logical Unit Name or Number (LUN) as well as specifications for 
the I/O operation to be performed. 

The UAT is also created by the user. It is a series of two-word entries, each of 
which equate the LUN (specified in the IOB) to a specific device. 

S he following IOB description applies to all standard IOX handlers. The description 
s annotated to include File Manager functions. IOB organization for non-standard 
handlers (for example, the IEEE Intelligent Cable Handler) is described in Section 7. 

2.1 INPUT/OUTPUT BLOCK (IOB) - 10 WORDS 

The IOB must be set up by the user within his own program. Word 0 is temporary 
storage and will be destroyed by IOX each time 10: is called. Words 1 and 2 are set 
, *-o the device name by 10:. Words 3-7 are parameters passed by the user on calls to 
V,.0:. Words 5 (bits 8-15) and 8 contain information returned to the user from IOX. 

Word 9 is used only on devices which support direct access I/O (i.e., disk, floppy 
disk). (Npte that IOB tables are not required for Fortran tasks. Refer to the 
Fortran Operations Manual). Figure 2-1 illustrates the IOB configuration. 

'Sample IOB*s are included in TASK1, TASK2, and TASK3 of the RTX Demo Program. Refer 
to Chapter 1, Section 6. 


k urd 0 


Temporary Storage for Use by IOX. This word is used by IOX as a 
pointer to queue requests for each device. It must NOT be altered by 
the user. 


Word 1 


Device Type (Two ASCII Characters). This word is set by IO:. 
contains the two character mnemonic for the device type.’ 


Word 2 


Device Number. This word is set by 10:. By convention it contains two 
ASCII digits (0-9) and is used to distinguish between multiple devices 
of the same type. 

I CAUTION 


Words 1 and 2 are used for temporary storage during calls to 10: and 
are only valid after one of the complete exits has been taken. These 
locations must not be changed when the busy bit in word 5 is set. 
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INPUT/OUTPUT BLOCK 


Standard 

Name* 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 


CHAIN POINTER (RESERVED FOR USE BY IOX) 


DEVICE TYPE 


ICUN or 
ITCB 


DEVICE NUMBER 


COORDINATION DUMBER 


LOGICAL UNIT NAME/NUMBER 



r E p 

r, H NO BAD n DEV. 

s l I/O LUN R UN- 

Y r M RESP 


DEVICE I NT. 
POS. USE 




REQUESTED COUNT 


OP 

CODE 


ACTUAL COUNT/PROMPT CHARACTERS 




DIRECT ACCESS ADDRESS 


Figure 2-1. IOB Configuration 


refer to the I/O Handler listing at the end of Section 3 
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Word 3 

( 



I/O Coordination Number. This word is supplied by the user to 
coordinate his I/O requests. If this word is non-zero, the device on 
which the call is being made will be dedicated to the coordination 
number supplied. When a device is dedicated to a specific coordination 
number, only those requests with matching numbers will be honored. All 
others will be queued until the device is released. If device dedi¬ 
cation is not required, this word should be set to zero. 

Logical Unit Name/Number (LUN) . This word is supplied by the user and 
it describes the Logical Unit on which the I/O should take place. 
Although the LUN may be any 16-bit value, by convention all negative 
numbers are considered to be ASCII character pairs (e.g., SI, LO). All 
positive numbers are considered to be FORTRAN unit numbers (e.g., 
5,6,10). 

Status, Function Code. This word uses the following format: 




Bits 15-8 Status returned to the user by IOX. The breakdown of bits is as 

fellows: 

Bit 15 Busy (the operation has not been completed) 

Bit 14 Error (an unrecoverable error has occurred) ; or bit 11 or 12 is 

set for the File Manager. * 

Bit 13. No I/O performed (e.g., LUN is assigned to dummy device, device 

cannot perform the requested operation, LUN not in assignment 
table. Read or Write with zero (0) count). 

Bit 12 Invalid LUN (LUN cannot be found in Unit Assignment Table) ; or 

File Manager access mode error. 
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Bit 11 


Bit 10 


Bits 9 
and 8 

Bit 7 

Bits 6 
and 5 

Bits 4-0 

Bit 4 

Bits 3 
and 2 


Bits 1 
and 0 
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Bottom of form (listing device only); or File Manager end of 
medium, directory full, directory error, device not labeled or 
partition busy. 


Device unresponsive (the device has not responded to the request 
in a reasonable length of time); not used by the File Manager. 


Position of device: 

00 Indeterminate 
01 Beginning of device 

10 File mark found 

11 End of device (disk and Magnetic tape only). For tape, the 
EOT reflective marker was encountered. For disk, the last 
sector in the extent was accessed. This status does not 
necessarily mean that no data was transferred. 

* 

This bit is for INTERNAL use only. Initialize to zero and 
do not ALTER. 

Reserved for future expansion 


Requested Function Code. This is supplied by the user and defines 
the operation to be performed on the device. The breakdown of 
bits is as follows: 

Special Operation - If this bit is set, bits 3-0 are ignored. 

This is to allow users to supply drivers for devices which perform 
special functions. 

Operation Code 
00 Read 
01 Write 

10 Position 

11 Function 

Operation Modifier - These bits define the specific type of 
operation to be performed. Their meaning depends on the operation 
code. (Some operation modifiers vary for certain Handlers. These 
differences are noted accordingly.) 


For 

read: 

File Manager 

00 

Direct Access (MTIC only. Read Reverse) 

Random Access 

01 

Unformatted, Sequential 

Sequential 

10 

Formatted ASCII, Sequential 

Sequential 

11 

Formatted Binary, Sequential 

Sequential 

For 

write: 

File Manager 

00 

Direct Access 

Random Access 

01 

Unformatted, Sequential 

Sequential 

10 

Formatted ASCII, Sequential 

Sequential 

11 

Formatted Binary, Sequential 

Sequential 
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For 

position: 

File Manager 

00 

Absolute, Records 

No change 

01 

Absolute, Files 

No change 

10 

Relative, Records 

No change 

11 

Relative, Files 

No change 

For 

function: 

File Manager 

00 

Write File Mark 

No change 

01 

Punch leader 

Reserved 

10 

MTIC only. Control Edit; Line 
Printer only. Eject to Top-of-Form 

Set file deleted 
bit in DIB 

11 

MTIC only. Control Erase 

Update directoiy 
(New files only) 


Requested Count. This word is supplied by the user to specify the I/O 
length, which is defined as follows: 

For read or write functions, this word is the number of bytes to be 
transmitted (1 to 65,535). (If the operation is Write Formatted ASCII, 
IOX will alter the requested count to remove trailing blanks before 
calling the handler. This is done with an intermediate counter. IOB 
Word 6 is not altered.) 

For relative record or relative file positioning, this word is the 
number of records or files to skip. (A positive count means skip 
forward, a negative count means skip backward). 

For absolute record or absolute file positioning, this word is the 
actual record or file number to skip to. (For MTIC Handlers, the unit 
is rewound and placed offline if this word is equal to minus one.) 

NOTE: Positioning a file to absolute -1 (file marks or records) is a 

close file operation for the File Manager (refer to Section 5.1.3). 


Word 7 



Word 8 



Buffer Address. This word is supplied by the user to specify the start 
address of the I/O buffer. Note that this address is always a word 
address and that indirect addressing is not allowed. 


Actual Count/Prompt Characters. This word is returned to the user by 
the File Manager. It contains the number of records or files actually 
skipped (for relative position), the actual record or file skipped to 
(for absolute position), or the actual record length in bytes (for read 
or write). The File Manager will NOT read more bytes into the user’s 
buffer than requested, but will continue to count characters to estab¬ 
lish the physical .ecord length. 

On devices which are capable of prcxnpting, this word is used to hold up 
to two prompt characters. 




Word 8 contents will be assumed to be prompt characters if 
negative (bit 15 set). Bits 7-0 not equal to zero indicate 
two prompt characters; bits 7-0 equal to zero indicate only 

one prompt character (in bits 15-8}. 
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Direct Access Address. This word is the direct access data address 
within the device (current record number) r for devices capable of 
supporting direct access. For sequential access, this word will be 
incremented to the current logical record number after each access. 
For random access, the user stores the logical record number here. 


2.2 UNIT ASSIGNMENT TABLE (UAT) 


The Unit Assignment Table is not part of the standard IOX library; it must be "tailor- 
made" by the user for the particular configuration of devices he requires. Figure 
2-2 illustrates the UAT configuration. 


UNIT ASSIGNMENT TABLE 


15 0 word 



i 


The UAT is a table of two-word entries for each logical unit which can be referenced 
in calls to IOX, plus a terminating word containing the UAT word length. The first 
word of the entry is the Logical Unit Name/Number (LUN) which is referenced in the 
user’s IOB. It may be any value from 0 to 65535. 

The second word of the entry is the address of the corresponding DIB table. 

The last word in the table is.the count word. It is a negative quantity representing 
the number of words in the table, plus one; that is, two words for each entry, plus 
the count word itself, plus one. Thus, if there exist four two-word entries, the 
contents of the count would be minus 10, or -(4 x 2 + 1 + 1) . The count word must be 
the last word in the table, and must be labeled I:UAT, because this is the name used 
by IOX when referencing the UAT. (Refer to the sample UAT at the end of this section) . 

(C 
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2.3 STANDARD DIB NAMES 

The' following table shows the DIB names for all devices for which standard and non- 


standard handlers exist within IOX. The label is to be used as the 
UAT entry for each device the user wishes to include. 

Fortran 

Non-DIO Non-DIO 

second word 

DIO 

of the 

Fortran 

DIO 

Teletype Console 

D:TY00 

D:TYF0 

D :TY0D 

D ;TYFD 

Teletype Keyboard 

D:TK00 

D:TKF0 

D:TK0D 

D:TKFD 

Teletype Tape Reader 

D:TR00 

D:TR00 

D:TR0D 

D:TR0D 

Teletype Punch 

D:TP00 

D:TP00 

D:TP0D 

D:TP0D 

CRT Console 

D:TY00 

D:TYF0 

D:TV0D 

*— 

CRT Keyboard 

D:TK00 

D:TKF0 

D:TV0D 

— 

High Speed Paper Tape Reader 

D:PR00 

D :PR00 

D:PR0D 

D:PR0D 

High Speed Paper Tape Punch 

D:PP00 

D :PP00 

D:PP0D 

D:PP0D 

Centronics Line Printer 

D:LP00 

D:LPF0 

D:LP0D 

D:LPFD 

Tally Line Printer , 

D:LP10 

D:LPF1 

— 

— : 

|pata Products Line Printer 

D:LP20 

D:LPF2 

— 

— 

Card Reader 

D:CR00 

D.-CR00 

D:CR0D 

D:CR0D 

Disk (43 series, fixed platter), unit 0 

D:DK00 

D-.DKFO 

— 

— 

Disk (43 series, fixed platter),*unit 1 

D:DK02 

D:DKF2 

— 

— 

Disk (43 series, fixed platter), unit 2 

D:DK04 

D:DKF4 

— 

—— 

Disk (43 series, fixed platter), unit 3 

D:DK06 

D:DKF6 

— 

— * 

Disk (43 series, removable platter), unit 0 

D:DK01 

D:DKF1 

— 

— 

Disk (43 series, removable platter), unit 1 

D-.DK03 

D:DKF3 

— 

— 

Disk (43 series, removable platter), unit 2 

D:DK05 

D:DKF5 

— 

—— 

Disk (43 series, removable platter), unit 3 

D:DK07 

D:DKF7 

— 

— 

Storage Module Disk, unit 0 (cylinders 0-201) 

D:SM00 

D:SMF 0 

— 


Storage Module Disk, unit 0 (cylinders 202-403) 

D:SM01 

D:SMFl 

— 

— 

Floppy Disk, unit 0 

D :FD00 

D: FDF 0 

— 

— 

Floppy Disk, unit 1 

D:FD01 

DsFDFl 

— 

— 

Floppy Disk, unit 2 

D:FD02 

D :FDF2 

— 

— 

Floppy Disk, unit 3 

D:FD03 

D:FDF3 

— 

— 

Magnetic Tape, unit 0 

D:MT00 

DsMTOO 

D: MC 00 

— 

Magnetic Tape, unit 1 

D :MT01 

D:MT01 

D:MC01 

— 

^Magnetic Tape, unit 2 

D:MT02 

D:MT02 

D:MC02 

— 

^Magnetic Tape, unit 3 

D:MT03 

D:MT03 

D:MC03 


IEEE Intelligent Cable 

— 

— 

D:IEOD 

— 
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2.4 SAMPLE UAT 


When creating the UAT, the user must declare I:UAT in a NAM directive, and any of the 
Standard DIB names in an EXTR directive, e.g,: 

l 


UATTOP 



i vr 


NAM 

T: UAT 


KXTK 

D:CROO, D:LPOO, 

D:TKOO, D:LPFO 

DATA 

' CR’ 

Card Reader Entry 

DATA 

D:CROO 


DATA 

'LP' 

Centronics Line Printer Entry 

DATA 

D:LPOO 

- 

DATA 

'Cl 1 

Command Input Entry 

DATA 

D:TKOO 


DATA 

’CO* 

Command Output Entry 

DATA 

D:TKOO 


DATA 

5 

FORTRAN Unit 5 , 

DATA 

D:CROO 


DATA 

6 

, FORTRAN Unit 6 

DATA 

D:LPFO 


DATA 

UATTOP-I:UAT-2 

Table Length 


c 

c 



( 

\ 


(C 
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section 3 


I/O HANDLER ORGANIZATION 


The purpose of an I/O handler routine is to set up and execute the actual I/O instruc¬ 
tions (normally interrupt-driven Auto-I/O instructions) necessary to perform an input' 
or output operation to a specified device. The I/O operation and the Logical Unit 
Name/Number are specified in the user's IOB, and the I/O must be performed within the 
constraints of the device as specified in the CIB and DIB. (These tables are des¬ 
cribed fully in section 4.) A listing of the Character-oriented I/O handler is 
included at the end of this section. . 


j^.l THE STANDARD HANDLERS 

Each standard IOX handler is described below. Refer to Section 7 for descriptions of 
non-standard handlers and to Publication No. 93325-00 for the A/D, D/A Handler. 

3.1.1 Character-oriented Device Handler (non-Fortran) 

This handler performs I/O, according to specifications within the applicable CIB, 
for the teletype, high speed reader and punch, and line printer. (A complete 
- listing of this handler is found at the end of this section.) 

3.1.2 Fortran List Device Handler 

This handler exists for I/O to the teletype console, teletype keyboard and line 
printer when used as a list output device under Fortran. It differs from the 
previously described handler in that it recognizes and processes Fortran carriage 
control characters; i.e., a "1" character as the first print character signifies 
top-of-form, and a *0' signifies double spacing before printing. (A top-of-form 
^ function to the teletype consists of six consecutive line feeds). 

/ • . 

Note that the Fortran task does not use an IOB, but rather Fortran I/O state¬ 
ments; these are passed through the Fortran/RTX I/O Interface routine which sets 
up an internal IOB for the user, according to the DIB's he has included in his 
Unit Assignment Table. The Fortran I/O handler is entered because the third 
character of the device name in DIB Words 5 and 6 is an "F"; thus ,, LPF0 M will be 
processed by the Fortran handler, and "LP00" will be processed by the standard 
character handler. * 

3.1.3 Card Reader Handler • 

The card reader handler is similar to the standard character handler except that 
input characters are converted to ASCII before returning. 
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"$.1.4 M.n|n<‘tic Tap** Handler 

11 

| The Magnetic: tape handler processes I/O for magnetic tape devices, and will 

/ perform read, write, write end-of-file and reposition functions. 

3.1.5 Disk and Storage Module Disk Handler (Non-Fortran) 

The IOX disk handler allows the RTX user to communicate with the disk. The 
communication takes place through IOX and the standard calling sequence is used. 

The user calls the IOX disk handler by making a standard call to IOX with an IOB 
which contains a LUN assigned to a disk DIB. The op-code must be either read- 
direct access or write-direct access. 



Data Formats 



The IOX disk handler supplies no formatting information of its own. It just 
reads (or writes) the number of bytes requested by the user. The length of each 
"record" is unknown (supplied by calling program) and therefore the disk handler 
is unable to read variable length records without some form of external format¬ 


ting routines. 


The IOX disk handler can support multiple '’extents*' on each disk and can allow 
access to them as if each were a separate disk unit. Extents are simply regions 
on the disk which may be defined by the user to be handled separately. Without 
any outside action by the user, IOX will process contiguous records throughout 
the extent. Each record contains the number of bytes requested in the I/O call, 
and each record starts at the beginning of a sector. Therefore, for fixed length 
records, each extent may be considered as a sequential file. 


In order to allow "direct access", each sector has a "relative sector number". 
The user may direct the IOX disk handler to process a particular record by ini¬ 
tializing IOB Word 9 (IOB Direct Access Address) in the IOB used for the I/O 
call. At the completion of each request, this address is appropriately incre¬ 
mented by the IOX disk handler so that the next request will process the next 
record. If the record contains 1-512 bytes, the address will be incremented by 
one; 513-1024 bytes, the address will be incremented by two; etc. Note that the 
relative sector number and relative record number may not agree (in fact they 
will not agree if the records are larger than 512 bytes). 


Extents are defined in the disk DIB's. The standard Disk DIB' s (DK00 and DX01) 
define an extent as an entire platter (200 cylinders, 2 heads). The user who 
wishes to utilize several extents on a single platter may do so by creating his 
own disk DIB’s, using the following variables within each DIB to define the 
parameters of the desired extent: 

a. The number of sectors per track (may be less than the physical number). 

b. The starting sector number (when added to the number of sectors per track 
must be less than or equal to the physical number per track). 

c. The number of heads per cylinder (may be less than the physical number). 

f d. The starting head number (when added to the number of heads per cylinder must 

be less than or equal to the physical). * 

, r> ^ 11 /*?£ 
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e. The number of cylinders the extent occupies. 

.f. The starting cylinder (when added to the number of cylinders must be equal to 
or less than the physical). 

g. The drive number. 

The IOX disk handler does not check for validity of the resulting sector, head, 
and cylinder numbers. It assumes that the dimensions and offsets supplied in the 
DIB are valid. This allows the user to take advantage of the "flag” bits des¬ 
cribed in the Disk Interface Manual. 

Contiguous sectors occur in the following sequence: 

a. Consecutive sectors on a single track (up to the number of sectors per track). 

b. The same sectors on the next head (up to the number of heads per cylinder) . 

c. The same sectors and heads on the nejct cylinder (up to the number of cylin¬ 
ders) . 

The disk handler requires four additional words (five if under Fortran) in the DIB 
which are not required for the other handlers. These axe DIB words 11-14, (11-15 
if under Fortran) and are described in section 4. 

3.1.6 Floppy Disk Handler (Non-Fortran) 

An "extent” on a floppy disk is constructed as described for the disk handler, 
taking into account the size limitations in the number of cylinders, heads, and 
sectors: 

Cylinders per Floppy Disk platter = 77 (00-76) 

Heads per platter = 1 (single surface) 

Sectors per track = 26 (00-25) 

Words per sector =64 

There exists within RTX a standard Floppy Disk DIB (D:FD0O) whose extent is 
defined as an entire platter. The user may define his own DIB's as described in * 
the disk handler description. 

J.1.7 Disk, Storage Module Disk, and Floppy Disk Handler (Fortran) 

Fortran tasks require a certain minimum amount of file management to be performed 
by the disk handler. The Fortran disk handler differs from the standard disk 
handler as follows: 

The random access address within the IOB is maintained by the Fortran disk 
handler itself, rather than the user, since the Fortran task does not create 
its own IOB. 

The Fortran disk handier can write and recognize an end-of-file mark. This 
is a 2-character ASCII record comprised of ”/*” characters. 


c 
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The determination as to whether a Fortran or a non-Fortran disk handler is to be 
used is made on the basis of the device name in Words 5 and 6 in the DIB. If the 
third character is an "F", it signifies Fortran, and the Fortran disk handler is 
used. 


In addition, a sixteenth word (Word 15) is required in a Fortran DIB. This word 
is used for storage of the current relative record number, which would normally be 
maintained in IOB Word 9. Since the Fortran user does not have access to the IOB, 
the Fortran/RTX I/O Interface routine keeps this information in the DIB. 

.1.8 Magnetic Tape Intelligent Cable (MTIC) Handler 


The MTIC handler controls data transfers between Pertec or Pertec-compatible 
formatters and tape transports and the central processor* The handler performs 
read, write, write filemark, rewind and offline, control edit, control erase, and 
reposition functions. 


l v “/0 HANDLER REQUIREMENTS 



he user may write his own handler routine for any type of I/O device he wishes. The 
equirements for any I/O handler to be run under control of IOX are as follows: 


Since all I/O under RTX must be done under interrupts, the word and block inter¬ 
rupt locations must be set up prior to I/O. 


* time-out sequence must be included to avoid the possibility of the device 
"hanging-up" indefinitely without completing its operations. The real time 
clock, via the RTX DELAY: call is normally used for this purpose. 


ka©¥i 


The user must not attempt to manipulate the real time clock by 
any means other than through the DELAY: call, as this will 
adversely affect the operation of RTX. 


nee I/O is initiated, the handler should pass control back to the IOX scheduler. 
This permits other I/O operations to be executed simultaneously if requested. 


The I/O handler should resume control upon either an end-of-block interrupt or 
upon watchdog time-out, to check the status and return to the caller at either the 
normal or the abnormal return location. 


Several IOX- internal subroutines (described below) currently exist to aid the standard 
landlers in accomplishing the above requirements. The user-written handler may use any 
)f these routines he wishes. The names of any of these routines must be declared in 
^XTR or REF directives within the user's handler. 
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3.2.1 SINT: (Set up an Instruction at the Word Interrupt Location) 
Calling sequence: 

/ EXTR SINT: 


LDX 

JST 

DATA 

Returns with: 


CIB Address 
SINT: 

: XXXX 




INTERRUPTS-UNCHANGED 

STATUS-UNCHANGED 

A-REGISTER-UNDEFINED 

X-REGISTER-UNCHANGED 


ere :XXXX represents a constant which is added to CIB Word 1 to form an interrupt 
instruction: 

SINT: does the following: 

1 . 


c. 


It determines the word interrupt location of the device. This address must 
reside in CIB Word 21. 

It calculates and stores an instruction into the word interrupt location. The 
actual instruction stored is the arithmetic sum of (contents of CIB Word 1) + 

(:XXXX), where :XXXX may be any positive or negative value. 




£ 


The standard CIB's contain a "SEL DA,7" instruction in word 1. 

Preparation is then made for a subsequent call by the handler to the SIO: routine 
(the handler need not call SIO:, however). This preparation consists of trans¬ 
ferring the contents of DIB Word 8 into CIB Word 12. 


(In the standard DIB's Word 8 will contain various function codes which are required 
for SELECT instructions in order to initiate an Auto I/O sequence during the SIO: 
routine. If the specific handler does not call SIO:, DIB Word 8 need not be preset.) 


3.2.2 SIO: (Start I/O and Watchdog Timer) 
‘ Calling sequence: 


EXTR 


SIO: 


L 


LDA 

DPTR 

LDX 

CIB address 

JST 

SIO: 
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Returns with: 

Does not return directly; if the INTP: subroutine is used, a return will ulti¬ 
mately be made in the following state: 

( 

INTERRUPTS-ENABLED 

STATUS-WORD MODE OV RESET 

A-REGISTER-UNDEFINED 

X-REGISTER-CIB Address 

DPTR is an address pointer to a two-word information block: 

Word 1: Positive number of bytes to be transferred. 

Word 2: Word address of I/O buffer. 

(Note that the standard handlers use CIB Words 26 and 27 for this information). 
1<r" SIO: routine does the following: t 

] Negates the byte count pointed to by the A register, and stores it into the Word 
interrupt location plus one. ' 

,2. Shifts the Buffer address pointed to by the A register to the left by one bit 

(converts to a byte address) , then decrements the byte address and stores it into 
the word interrupt location plus two. 

( MOTE | 

(Steps 1 and 2 above complete the three-word Auto I/O sequence. 

( The AIN/AOT instruction itself may be generated by a call to SINT:) 

3. Calculates the delay count required for the watchdog timer, as follows (assume a 
ten millisecond Real Time Clock rate): 


a. 



b. 


c. 


The negative byte count created in step 1 is loaded into the A register. 

The contents of CIB Word 20 are stored in-line and executed as an instruction 
The contents of the A register are then negated (converted to positive) and 
incremented by 1000. 



Steps a, b and c above compute the number of RTC M ticks” (normally 10 milliseconds 
each) to delay during the I/O operation. Since the number is constructed begin¬ 
ning with the byte count (step a) and incremented by 1000 (step c) the minimum 
delay possible is ten seconds, plus ten milliseconds for each data byte to be 
transferred. The purpose of step b is to permit a larger delay, if necessary. 

For example, CIB Word 20 can be set up by the user, when constructing the CIB 
pr> r to execution, to be a shift instruction (e.g., "LLA l n ) which would double 
the value in the A register, and thus cause a twenty millisecond delay for each 
data byte (plus the ten second constant). Note that the instruction in CIB Word 20 
is executed before the byte count in the A register has been converted from 
negative to positive, and before the constant 1000 is added. If the minimum delay 
(ten seconds, plus 10 milliseconds for each byte to be transferred) is adequate, 
then the instruction in CIB Word 20 should be zero (a no-op instruction) . It is 
the responsibility of the user when creating the CIB table for his handler to 
determine how large a delay is required to permit completion of an I/O operation, 
and thus what instruction (normally LLA K, where K must be determined) is to be 
stored into CIB Word 20. 
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Sets up and executes the following I/O instructions: 


SEL 

DA, X 

Handler-determined 

function 

SEL 

DA, 5 

Set word transfer mask 

SEL 

DA, 6 

Set block transfer 

mask 

SEL 

DA, Y 

Handler-determined 

function 


X and Y represent the function codes in bits 15 through 13 and 12 through 10, 
respectively, of CIB Word 12* (These function codes were originally copied from 
DIB Word 8 in a prior call to SINT:.) Note that if Select instructions of func¬ 
tion X and/or Y are not required by the device, they can be organized in the DIB 
so that X=5 and Y=6, so that each is executed twice, or they can be set to a 
function code which has no meaning to the device, if such a code exists. 

[ "hots ~] 

If these function codes are all zero, it indicates an operation 
under Distributed I/O. 

/ 

If the device uses function codes 5 and 6 for other purposes than 
to set the transfer masks, the user may wish to perform the Select 
functions within the handler itself, rather than calling SIO: . 

Once the Select instructions have been executed, a call to RTX DELAY: is made, 
carrying the calculated delay time described in step 3 above. 

If the Watchdog Timer expires before an end-of-block interrupt occurs, the in¬ 
struction in CIB Word 1 (normally "SEL DA 7 M ) is executed to disable interrupts 
for the device, and the "Error*' and "Device Unresponsive" status bits are set in 
the DIB, and control is then passed to the EOR: routine at EORST:. 


| Edging I 

SIO: does not set up the end-of-block interrupt location. This 
must be done in the handler. 


3.2.3 INTP: (End of Block Interrupt Return Point) 

The INTP: routine cancels the watchdog timer upon end-of-block interrupt, and passes 
Control to the return address of SIO:. Thus INTP: is an extension of SIO:, and is 
intended to be used only in conjunction with SIO:. 
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TcA~all INTP: at end-of-block, the handler should, prior to calling SIO:, set up the 
following sequence at the end-of-block interrupt location: 


JST 

*$+l 


DATA 

TAG 


1 

Example : 

EXTR 

INTQ:,INTP: 

TAG 

ENT 



JST 

INTQ: 

• 

DATA 

$,0,0,0 


DATA 

INTP:,8180,0 


DATA 

CIB Address 


DATA 

TAG 


where TAG is a short calling sequence to the RTX INTQ: subroutine, which points to 
INTP: as the task to fc>e queued. 

(T^Juser should first familiarize himself with the RTX INTQ: description in chapter 1 
R^ Functions) . 

The above description is the method used by the standard I/O handlers for end-of-block 
interrupts. For this purpose, the first 12 words of the applicable CIB may be used to 
contain the calling sequence to INTQ:. 


For example, the following is a representation of the first twelve locations within the 
CI^ or the line printer: 


( 





C : L P 0 

— L 

1 N E 

PRINTER 

LOC 

INST ADDR 

LABEL 

MNEM 

OPERAND COMMENT 

0000 



NAM 

C: LP0 



X 


EXTR INTQ:.INTP:,1:READ,1:RITE,1:FUN 



JL 

X 

A -V ^ 

A #% 

******************* 


0004 

DA 

EQU 

4 


0042 

INTAD 

JL 

EQU 

:42 



* 

JU JL A 
TV 4 % 4 % 

******************* 

0000 


* 

REL 

0 


0000 

C: LP0 

EQU 

$ 

0000 

0800 

CIB 

ENT 


000 ! 

4027 


SEL 

DA,7 SELECT — FC = 7 

0002 

f 900 


JST 

INTQ: 

0003 

0003 


DATA $,0,0,0,INTP:,8l80,0,CIB,CIB 

0004 

0000 




0005 

0000 




0006 

0000 




0007 





0008 

1FF4 




0009 

0000 




000A 

0000 




000B 

0000 
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Note that the end-of-block interrupt location contains a JST into the CIB itself; Word 
1 of the CIB is the SEL DA,7 instruction used by the SIO: routine. It is also executed 
at end of block, thus serving as a convenient method to turn off the interrupt masks 
following an I/O operation. 


Following this instruction is a JST to INTQ: followed by the required parameters, of 
which INTPr is the task to be executed. Note also that this sequence will automati¬ 
cally cause the X register to be loaded with the CIB address upon entry to INTP: . 


3.2.4 WAIT: (End of Record Delay Routine) 
Calling sequence: 


LDX 

JST 

eturns with: 


CIB Address 
WAIT: 


INTERRUPTS-ENABLED 

STATUS-UNCHANGED 

A-REGISTER UNDEFINED 

X-REGISTER-CIB Address 



The WAIT: routine utilizes the delay length specified in DIB Word 7 to delay a suffi¬ 
cient length of time at end-of-record to ensure that the device is physically ready to 
erform the next I/O request. (Generally, one character time is sufficient for this 
^delay.) 

The routine loads the delay count from DIB Word 7 depending on the I/O instruction at 
the Word interrupt location; i.e., if bit 13 of the I/O instruction is on, it is as¬ 
sumed to be an output instruction, and bits 0-7 of DIB Word 7 are used as the delay 
* count. If bit 13 of the I/O instruction is off, it is assumed to be an input instruc¬ 
tion, and bits 8*^15 of DIB Word 7 are used as the delay count. Once the delay count is 
established, a call to RTX DELAY: is made; upon return from the delay, the routine 
/ 'ixits to the caller. 


( 3.2.5 EOFQ: (End of File Check Routine) • j 

Once an end-of-block interrupt has occurred, EOFQ: may be called as follows: j 

/ * 1 
LDX CIB Address ' . | 

JMP EOFQ: . j 

This routine does the following: . 

1. Examines the first two input .characters in the buffer to determine whether they 
are •/*’ 

2. If so, control is passed to the EOF: routine. 

3. If not, control is passed to the EOR: routine. 


(C 


II/3-9 




Compiler Automation 


li 

i 

I; 


c 



I :.2.G COP: (End of File Routine) 
V ing sequence: 


LDX CIB Address 

JMP EOF: 

he EOF: routine is entered when it has been determined that an end-of-file has been 
ncountered (the routine EOFQ: may be used to determine this). 

’he routine stores a zero value into CIB Word 28, loads the A register with an end-of~ 
ile status, and transfers control to the EOR: routine at EORST:. 


.2.7 EOR: (End of Record Routine) 



sequence: 


LDX CIB Address 

JMP EOR: 




his routine is entered when the handler has completed the requested I/O operation and 
ishes to return to the calling task. 


be/~outine loads the A register with the current status from CIB Word 32, and con- 
inL s at EORST:. 


( 

i.2.8 EORST: (Alternate Entry Point to EOR:) 

EORST: and EOR: are alternate entry points to the same end-of-record routine. The 
difference between the two is that EOR: loads the I/O status word into the A register 
rom the CIB. EORST: assumes that the status is already in the A register. 



^ l.DX CIB Address 

EDA I/O status (from handler) 

JMP EORST: 

he routine does the following: 

. It conies the actual transfer count of the I/O operation from the CIB into Word ■ 8 
of l.) 2 IOB. • 


It stores the status of the I/O operation (in the A register upon entry) into 
bits 15-8 of IOB Word 5. 

It performs an RTX BEGIN: call, passing as a parameter the normal or abnormal 
return address of the caller, depending on the status. The abnormal return 
^address is taken if any of bits 9, 10, 11, or 14 are set in word 5 of the IOB 

It calls WAIT: to perform an end-of-record delay. 


r t/I— in 


1 1 /* 7 £ 






C 

5. It loads CIB Word 1 (assumed to be "SEL DA,7), masks off the low order two bits 
• (to make it a SEL DA,4 or initialize instruction) and executes it in-line. 

6. It empties the IOCH (I/O suspend) list into the HEADY list. 

7. It then transfers to the IOX request scheduler routine to check to see if another 
request is pending for any device on the controller just used. 

3.2.9 FETCH: (Input one character from an I/O device) 

Calling sequence: 

FETCH: 


CIB Address 

FETCH: , 

Returns with: 

INTERRUPTS-ENABLED 

STATUS-UNCHANGED • 

A-REGISTER—CONTAINS INPUT BYTE 
X-REGISTER-UNCHANGED 

he FETCH: routine calls WAIT: to wait one character time, then calls SIO: to perform 
a one-character I/O operation. Upon input of the character, it is checksummed, and 
the subroutine exits back to the caller. 

The following assumptions are made by FETCH:. 


b 


EXTR 


LDA 

JST 


1. The handler has previously zeroed out the checksum word (CIB Word 13) at the 
start of the record. 



i 


There exists in CIB words 34 through 37 the following sequence: 


DATA 

$+i . 

Pointer to byte count 

DATA 

i 

Byte count (1 character) 

DATA 

$+i 

Buffer address 

DATA 

0 

One-character input buffer 


which are required for FETCH:'s call to SIO:. 

Upon return from FETCH:, the input character is in CIB word 37 as well as in the 
A register, and the cumulative checksum is in CIB word 13. 


(C 
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3.2.10 BUFFQ: (Store input character into buffer) 


Calling s equence: 


l EXTR 


BUFFQ: 


CIB Address 
BUFFQ: 


Returns with: 


INTERRUPTS-ENABLED 

WORD MODE 

OVERFLOW-RESET (unless buffer filled) 

A-REGISTER-CONTAINS INPUT BYTE 

( X-REGISTER-UNCHANGED , 

T BUFFQ: routine is.designed to be used following a call to FETCH: , in that it moves 
CIB word 37 (stored into by FETCH:) into the user's buffer. The step-by-step procedure 
is: 

1. The overflow register is reset. 

2. The actual transfer count (CIB Word 28) is incremented. 

3. The actual transfer count is compared to the requested count (CIB word 26). 

4^ If the actual count is greater (indicating that the buffer is already full), the 
buffer address (CIB Word 27) is incremented and the subroutine exits. 

5. " If the actual count is less, CIB Word 37 is copied into the user's buffer pointed 

to by CIB Word 27. Then Word 27 is incremented and the subroutine exits. 

6. ^" If the actual count is equal (indicating that this character will cause the 
^►buffer to be full), overflow is set and CIB Word 37 is copied into the user's 

^ buffer pointed to by CIB Word 27. Then Word 27 is incremented and the subroutine 
( exits. 


3.2.11 UNRES: (Unresponsive Device Routine) 


Calling sequence: 


EXTR 


UNRES: 


CIB Address 
UNRES: 
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3.2.12 


IORTN: (Return to I/O Scheduler) 


Calling sequence: 

EXTR IORTN: 


LDX CIB Address 

JMP IORTN: 

• In practice, an I/O handler is a subroutine with an abnormal calling sequence (a JMP 
instruction is used, rather than a JST). This is because I/O handlers are only 
••called" from one location, and thus the return is known. This return address is 

IORTN:. Therefore, once an I/O operation has been initiated, a jump to IORTN: must 

be made. Note that if the SIO: routine is called, it will exit to IORTN:. 



CHARACTER-ORIENTED DEVICE HANDLER LISTING 


The following listing illustrates the standard Character-oriented Device Handler 
(non-Fortran) written for an LSI-2 processor. The code also includes a table of 
equates used by RTX, its subexecutives, and its library modules, as well as a listing 
of the TTY console DIB (D:TYOO) and TTY CIB (C:TYO) . CONCORDANCE listings provide 
an alphabetized map of all symbols. 


c 

( 
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'ATES 


RIXEQU - EOUATFS USED IN RTX 



000 3 


A A * 

A A A A 

A 

A A A 

AAAAAAAAAAAA 

A A 

A 

A 

A 

A 

A 

A 

A 

A 

0009 


* 

1 HE EUUATES CONTAINED IN THIS ASSEMBLY 










0005 


A 

ARE USED 

BY R I X 

AND ITS SUBEXF CU1IVES 

AND 









0006 


A 

ITS LIBRARY MODULES 










0007 


A 














0006 


A 

IT MUST 

BE ASSEMBLED AND THE SYMBOL TABLE 









0009 


A 

GENERATED BE PASSED TO THE RTX MODULE 










00 10 


A 

BtlNG 

ASSEMBLED 










001 1 


A 














0012 


A A A 

A * A A 

★ 

AAA 

AAAAAAAAAAAA 

A A 

A 

A 

A 

A 

A 

A 

A 

A 

0013 


A 














0019 


A 

EQUATES 

COMMON 

TO SEVERAL BLOCK TYPES 










0015 


A 














00 th 


AAA 

* * * * 

A 

A A A 

aaaaaa-aaaa aa 

A A 

A 

A 

A 

A 

A 

A 

A 

A 

00 1 7 


A 














00 1R 

0 000 

CHAIN 

EOU 

0 


P UI N 1 F R J(J NEXT BLOCK 










00 19 

oooi 

PR I 

LOU 

1 


PRIORITY (BITS 15-3) 










0020 

0003 

CN 

EOU 

3 


COORDINATION NUMBER 










0021 

0002 

UUEUE 

EOU 

2 


TOP OF DUE UF 










0022 


A 




V. 










0023 


AAA 

a * a a 

A 

A A A 

AAAAAAAAAAAA 

A A 

A 

A 

A 

A 

A 

A 

A 

A 

0029 


A 














0025 


A 

T C B 


E 0 

U A ! t S 










0026 


A 














0027 


AAA 

* A * * 

A 

A A A 

AAAAAAAAAAAA 

A A 

A 

A 

A 

A 

A 

A 

A 

A 

0028 


A 














0029 

0001 

STAPRI 

EOU 

PRI 

STATUS (BTTS 0-2) *. PRIORITY 

(BITS 

15 

- 

3) 


0030 

0002 

PREG 

EOU 

2 


PROGRAM REGISTER 










00 31 

0003 

ARLG 

EOU 

3 


ACCUMULATOR REGISTER 










0032 

0 009 

XREG 

EOU 

9 


INDEX REGISTER 










0033 


A 














0039 


AAA 

A A A A 

A 

AAA 

AAAAAAAAAAA A 

A A 

A 

A 

A 

A 

* 

A 

A 

A 

0035 


A 














0036 


A 

I 0 B 


E Q 

U A T .E S 








9 


0037 


A 














0036 


A A A 

A A A A 

A 

AAA 

A A' AAAAAAAAAA 

A A 

A 

A 

A 

A 

A 

A 

A 

A 
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0002 
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EQU 

0000 

ILUN 

EQU 

0005 

IS r A 

EQU 

0005 

IOP 

EQU 

0006 

IRCNT 

EQU 

0007 

I BUFF 

h QU 

0008 

I ACNT 

EQU 

0009 

I DA A 

EQU 
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90500-10 RTX » IOX EQUATES 

RIXEQU - EQUATES USED IN RTX 


1 DEVICE FYPE 

2 UNIT NUMBER 

? ADDRESS Of USER'S TCB 

0 LOGICAL UN 1 I NAME/NUMBER 

STATUS 
OP-CODE 

REQUESTED COUNT 

7 BUFFER ADDRESS 

8 ACTUAL CUUN1 TRANSMITTED 

9 DIRECT ACCESS ADDRESS 
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99500- i o R T x f 
Kixtuii - 


I Cl X 

EQU A T E S 


UUATtS 
USt.O IN 


R T X 


00S1 


* * * 

* * * * 

* * 

**************** 

0052 


* 




0053 


* 

C I 

0 

EQUATES 

0050 


* 




0055 


* * * 

* ft * * 

* * 

**************** 

0056 


* 




005 / 

0 0 0 0 

CHOP 

EQU 

0 

BEGINNING UF RECORD FLAG 

0056 

OUO 1 

csel; 

EDO 

1 

SELECT FC = 7 

0059 

0000 

ctmpi 

EDU 

4 

TEMP CELL 1 

0 0 b 0 

0005 

C TMP2 

EDO 

5 

TEMP CELL 2 

0061 

0006 

CTMP3 

EQU 

6 

TEMP CELL 3 

0 0 62 

0 00 7 

CEHT3K 

EQU 

7 

END UF BLOCK TASK POINTER 

0063 

0009 

CNEWA 

EQU 

9 

A REGISTER FOR EBTSK 

0060 

0 0 0 A 

CNEWX 

EQU 

1 0 

x REGIS’TFR FOR EBTSK 

0065 

OOOC 

CFUn 

EQU 

1 2 

TEMP CELL FOR I/O INSTRUCT 

0 0 66 

OOOD 

CCSUM 

EQU 

13 

CHECKSUM TEMP 

0067 

OOOE 

REUCN1 

EQU 

l a 


006ft 

0 OOF 

CJTBL 

EQU 

15. 

JUMP TABLE 

0069 

0013 

CSPIOP 

EQU 

19 

POINTER TU SPECIAL OP PROC 

0070 

0010 

CDEL 

EQU 

20 

DELAY MOD I F I C A T-I ON 

007 1 

0015 

CINTR 

EQU 

21 

POINTER TO INTERRUPT ADORE 

0072 

0016 

EXCESS 

EUU 

22 


0073 

0017 

CEOF 

EQU 

23 

- 

0 0 70 


* 




0075 


* 

FILLED 

FROM 

I OB 

0076 


* 




0077 

0010 

C I OB 

EQU 

20 

IOB POINTER 

007H 

00 1 9 

COP 

EQU 

25 

OPERATION CODE 

0079 

0 0 1 A 

CPCNT 

EQU 

26 

REQUESTED COUNT 

OOftO 

OO 1 0 

C8UFF 

EQU 

27 

BUFFER ADDRESS 

0061 

OOIC 

CTCNI 

EQU 

20 

TRANSFER COUNT 

0082 

0 0 11) 

COAA 

EUU 

29 

DIRECT ACCESS ADDRESS 

0003 


* 




0000 


* 

FILLED 

FROM 

DIB 

0005 


* 




0 0 06 

00 IE 

CD IB 

EQU 

30 

DIB POINTER 


* 




* * * * * 


s. 


****** 



) 
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MACR02 (A?) Sl= MACHOS H0= 


90500-1 0 HT X f 10X EQUATES 

PTXEGU F.QUA1ES USEf) IN HTX 


0 087 
0088 
0089 
0090 
0091 
0092 
0093 
009*1 
0095 
0096 


CFUN1 EQU 31 1EMP CELL 2 FOR FUNCTIONS 

* TEMP STORAGE USED BY JOX AND ITS DRIVERS 


0020 

* 

STATUS 

EOU 

32 

0021 

CRTN 

EQU 

33 

0022 

CDCHN 

EQU 

3 a 

0023 

CDCHN1 

EQU 

CDCHNF 1 

002 a 

CDCHN2 

EQU 

CDCHN t-2 

0025 

CDCHN3 

EQU 

COCHN+3 


DEVICt STATUS HURD 
RETURN.ADDRESS FROM 1:310 
START OF DATA CHAIN 
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MACR02 (A2) 81= MACRuS H0= 


9 4 5 0 0-tO RTX, lOX EUUATFS 

RTXEQU - EQUATES USED IN RTX 


0098 

0099 

0100 

0101 

010 ? 

0103 


0118 

0119 

0120 

0121 

0122 

0123 


****************** ************** 

* 

* DIB EQUATES , 

* 

****** ************************** 
* 


0104 

0001 

DC IB 

EQU 

1 

C IB POINTER 

0105 

0 0 0 4 

DSW 

EQU 

4 

DEVICE SPECIFICATION WORD 

010b 

0005 

01 

EQU 

5 

DEVICE TYPE 

0107 

0006 

OCIJN 

EQU 

6 

CONTROLLER ft UNIT NUMBERS 

0 1 OB 

0007 

DDtL 

EQU 

7 

END OF BLOCK DELAY TIMES 

0 1 09 

0008 

OFUN 

EQU 

8 

FUNCTION CODES * FLAGS 

0110 

0009 

PULS 

EQU 

9 

UPPER LIMITS 

0111 

0 0 0 A 

DERRC 

EQU 

1 0 

ERROR COUNTER 

0 112 

0 0 OB 

PS f R1 

EQU 

i 1 

DIU START ADDRESSES & MODES 

0 113 

0 0 08 

PSECT 

EQU 

1 1 

VERIFY FLAG, DRIVE A, STARTING SECTOR 

0114 

OOOC 

DHEAO 

EQU 

12 

SECTURS/TRACK & STARTING HEAD 

0115 

0 0 OP 

DC YL 

EQU 

13 

SECTORS/CYLINDER * STARTING CYLINDER 

0116 

000E 

DEOD 

EQU 

1 4 

NUMBER OF SFCTORS IN FILE 

0117 

OOOF 

DCSECT 

EQU 

15 

FORMATTED SECTOR NO 


* 

******* ************************* 
* 

* INTERRUPT BLOCK EQUATES 

* 

****************** ************** 


INTERRUPT BLOCK EQUATES 


0124 ‘ 

000 0 

NTAIO 

EQU 

0 

. I/O INSTRUCTION 

0125 

000 1 

N T C N T 

EQU 

1 

COUNT EUR AUTO I/O 

0126 

0002 

NT BUFF 

EQU 

2 

BUFFER ADDRESS - 1 

0127 

0004 

NTE08 

EQU 

4 

END-OF-BLOCK INTERRUPT 

0128 

0005 

NTEOBA 

EQU 

5 

ADDRESS FOR EOB INSTRUCTION 

0129 


* 




0130 


* * * 

* * * 

***** 

************** 

0131 


* 




0132 


* 

MlSCELLANEIOUS 

EQUATES 

0133 


* 
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0135 
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0137 
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0193 

0199 
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0196 
0197 
0 1 98 
0199 
0150 
0151 
0152 
0153 
0159 
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(A?) SI= MACROS 80= RTXEGU - EQUATES USED IN RTX 



* * * * 

* * 

***** 

* * * * 

******** 

* * * * 

0011) 

At 

ARROW 

EQU 

29 

BACKARROW FLAG SAME AS 

CD A 

0 0 0 3 

EORMSK 

EQU 

3 

END OF 

RECORD MASK 


0009 

EOFMSK 

EOU 

9 

END OF 

FILE MASK 


9000 

I : ERR 

EQU 

1 9000 




0800 

I :bop 

EQU 

5 800 




0900 

T:RES 

EQU 

:900 




0200 

I :EOF 

EQU 

: 200 




0100 

I : BOD 

EQU 

: loo 

BEGINNING OF DEVICE STATUS BIT 

0300 

I: EOD 

EQU 

: 300 


\ 


2000 

I:noio 

EQU 

: 2 o 0 0 




9000 

ERROR 

EQU 

: 9000 




00 1 F 

OPmSK 

EQU 

31 




00 80 . 

1 OREL 

EQU 

:80 




0003 

EORTYP 

EQU 

3 




0009 

PROMPT 

EQU 

9 




0006 

EUFTYP 

EOU 

6 


* 


0000 


IFF 

LSI305 




0005 

IOREQ 

EQU 

ENDC 

5 


/ 
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09 :^ ! o:^B 9 9 5 0 0 - 1 0 R T X , I (IX fc.nil A T F S 

MACRU2 (A 2; 

81= MACHOS 

HO = 

MAC 

R 0 S 

0218 


MACHU 

LLL 


0219 


IFF 

LSI 305 


0220 


ILL:: 

:1 HO,#1- 

1 

0221 


F.NOC 


, 

0222 

• 

IF r 

LSI305 


0223 


KEPT 

Al 


0229 


LLL : 



0225 


ENDC 



0226 


Enom 



0226 


macro 

LLL: 


0229 


LLX 

1 


0230 


Rl A 

1 


0231 


ENDM 


* 

0232 

00 1 0 

FORM 

LLLJ :, 12 

, 9 

0233 


MACRO 

INTSTF 

CIB INTERRUPT X DEVICE ADDRESS STUFF 

0239 


SPACE 

1 


0235 


DA EOU 

# 1 

define, device ADDRESS 

0236 


INTAD EQU 

#2 

DEFINE INTERRUPT ADDRESS (DATA) 

0237 


ABS 

INTAD 

ORG TO AIJTU 1/D LOCATION 

0238 


OATA 

0 ,0,0 


0239 


AHS 

I N T A D ♦ 9 

ORG TO END-OF-BLOCK INTERRUPT 

0290 


JS1 

*S + 1 

GO TO CIB FOR 

029 1 


DA T A 

C1B 

. END OF BLOCK 

0292 


REL 

0 

ORG TO RELATIVE ZERO (0) 

0293 


SPACE 

1 


0299 


ENUM 



0296 


macro 

SINT 

GENERATE CALL TO SETUP INTERRUPTS 

0297 


JST 

SINT: 

CALL SUBROUTINE 

0298 


IFF 

Alls] 


0299 


OATA 

: 3 8 0 0 

MAKES STOP 

0250 


NOTE ' 

UrFIRSI . 

parameter 

0251 


. ENDC 



0252 


IFF 

#2 111 


0253 


IFF 

#2(0) 
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EQUATES 


MACR02 (A?) 

S1= MACROS HO = 


MACROS 

0250 


DAI A 

:3800 MAKtS STOP 

0255 


NOTE 

IJ» SECOND.parameter 

0256 


EnOC 


0257 


Eni)C 


0258 


1F 1 

LSI305 

0259 


IFT 

#2 til 

0260 


DATA 

#3+:uoF9 

0261 


ENDC 


0262 


IFT 

A2 f 0} 

0263 


DATA 

#3 +:60F 9 

0260 


ENDC 


0265 


ENDC 


0266 


IFF 

LSI 305 

0267 


IF T 

#2 IIJ 

0268 


DATA 

#3+:13F9 

0269 


ENDC 


0270 


IFT 

#210) 

0271 


DATA 

A 3+!23F 9 

0272 


ENDC 


0273 . 


ENOC 


0270 


ENDM 


027b 


MACRO 

CIB 

0277 


T i TL 

'RiX/IOX CHARACTER 

0278 


TITt 

C : # 1 . . .CONTROLLER.I 

0279 


NAM 

C:# 1 

0280 


EXTR 

S C H : , I N T Q :, I M t p s 

0281 


XDEF 

#4 

0282 


XDEF 

*5 

0283 


XDEF 

tt b 

0280 


INTSTF 

A2,: #3 

0205 

CIB 

EOU 

% 

0286 

C: A 1 

OA T A 

SCH: 

0287 


IFT 

LSI305 

0208 


SEA 

0 A X 1 + 1 

0289 

. 

ENDC 
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MACRO? (A?) SI = MACROS H(t = 


9950 0- 1 0 RT'X, IlIX 
M A C W U S 


EuUAlES 


0290 

0291 

0292 

0293 

0299 

0295 

0296 

0297 

0298 

0299 

0300 

0301 

0302 

0303 

0 3 09 

0305 

0306 

0307 

0308 

0 309 

0310 

0311 

031? 

031 3 

0319 

0315 

0316 

0317 

0318 

0319 

0320 

0321 

0322 

0323 

0329 

0325 


IFF 
SEL 
ENUC 
JST 
DATA 
X REF 
XREF 
DATA 
XREF 
DATA 
LLA 
DATA 
RES 
OATA 
END 
ENDM 
MACRO 
TITL 
TITL 
NAM 
EX 1 R 
D:#l chan 
DATA 
rex i 

DATA 
END 
ENDM 
MACRO 
IFF 
EX TR 
ENIJC 
ENDM 
MACRO 
IFF 
. DATA 
ENDC 


LSI 305 
DAX1+1 

IN] q • 

*,0,o,0,1 ntp:,8180,0,C:91,C:»1,0,0,0 
n 9 

*5 

0 

96 

0 

a 1 

1NTAD 

12,0 

3>+l, 1 , $ + 1,0 


DIH 

'Rrx/IOX CHARACTER I/O DRIVERS 93302-1XE0 
0:91 ...DEVICE.INFORMAT ION.BLOCK 
D: U 1 
C: #3 
x: : 

C:93,0,0, :89 
92 

o , : U 5 ,: n 6 , o ,: a 7 


XDKF 
9 1 (0) 
1:91 


XREF 
» 1 (01 
1:91 
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MACK02 (A2) SI= MACHOS B0= 


99500-10 HTX, IOX 
MACHOS 


EQUATES 


0 3?6 


I FT 

0327 


DATA 

0328 


ENDC 

0329 


ENOM 

0330 


SAVE 

0331 


END 

0000 

ERRORS 


0000 

WARNING 



#1 f 03 
0 
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HACRU2 ( A 2) SI= CHRDS HO= D : T V 0 0 - TELETYPE CONSOLE 


0125 



* 

012f> 



****** 

0127 



* 

0 1?H 

0000 


NAM 

0129 



EX fR 

0130 



* 

0131 



****** 

0132 



★ 

0133 

0000 


i): TYOO CHAN 

013a 

00 0 1 

0 0 0 0 

DATA 


0002 

0 0 00 



0003 

0000 



0004 

5066 



0005 

041)9 



0006 

BOHO 


0135 

0007 

020C 

DATA 


0006 

0 A 6E 



0009 

4«00 



0 0 0 A 

0000 


0136 



END 

0000 

ERRORS 


0000 

warning 



********************* 

D J TY00 
C J T Y 0 

********* *********** 

x:: 

c: 1 YOr 0,0, J 5 <) 6 6 , ' T Y ' , 1 00 • 

:20C,:A 6 E,:aaoo,o 
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U 0000 X:: 013 3 

0136 SUURCfc LINES 





,,!l 


mu 


PAGE 

00 0 1 

09/01/76 

09:07: 

37 

HTX/IOX 1 

MACR02 

(A2) 

SI = 

CHRDS 

80 = 


c - : T '' 

0251 

00 00 




GAM 

C : T YO 

0 25 2 





EXTR 

INTO:, 

0253 





EXTR 

3CH: 

025« 

0002 




INTSTF 7,2 

0250 + 

0002 

000 0 





0250 + 

0003 

0000 





0250 + 

■OOOU 

0000 





0250 + 

0006 






0250 + 

0 0 06 

F 90 7 

0007 




0250 + 

0007 

0000 





0250 + 

0000 






0255 


00 0 0 


C: TYO 

F QU 


0256 

0000 

0000 


CIB 

DATA 

sch: 

0257 


0000 



IFF 

LSI 305 

0256 

00 01 

403F 



SEL 

DA,7 

0259 





ENDC 


0263 

0 0 02 

F 9 0 0 

0000 


JST 

INTQ: 

0260 

0003 

0 0 0 3 



DATA 

o 

O 

* 


0000 

0 00 0 






0 0 05 

0000 






0006 

0 0 0 0 






0 007 

0 0 0 0 






0 0 0 8 

IFF 9 






0009 

0000 






0 0 0 A 

0 0 00 






0 0 013 

0 0 0 0 





0265 

oooc 

0000 



RE S 

3,0 

0266 

0 0 0 F 

0000 



DATA 

I :RE AD 


00 l 0 

0 0 0 0 






0011 

0 0 0 0 






00 12 

00 00 






0 013 

0 000 





0267 

00 1 o 

1353 



LLA 

9 

0268 

0015 

0002 



DATA 

INT Al) 


o 

VERS 93302-1XE0 


Ml 


TELETYPE 


SELECT - FC = 7 


l :RE AD,I:RITE,0,1:FUN,0 


'l 

y 


motion 
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DATA S+lrlfS+1'0 


END 

0000 ERRORS 
0000 WARNING 


02b9 0016 0000 

0270 0022 0023 

0023 0001 
0024 0025 
0025 0000 

0271 


I/O DRIVERS 93302-1XE0 
1EIETYPE 
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MACR02 (A?) S1= CHRDS BO = CHARACTER REAO-WRIIE PROCEDURES 


0927 

ouoo 



MACH 


0 

MUST WORK UN LSI AND ALPHA/NM-16 

0928 

* 

it 

it 

* * * 

* 

* * * * 

*************** 

* * 

0929 

* 








0930 

* 



ORIGINATING NAMES 


0931 

* 








0932 

* 

* 

it 

A * * 

it 

* * * * 

*************** 

* * 

0933 

* 








0939 

0000 



NAM 


I TREAD 

INPUT reddest 


093b 

0 0 7 *4 



NAM 


I TRITE 

OUTPUT REUUFST 


0936 

0065 



NAM 


I T F U N 

SPEL1AL FUNCIIUNS PROCESSOR 


0937 

00B 3 



NAM 


RITE2 

OUTPUI F NO OF RECORD (CP,lF, 

ETC) 

0938 

* 

it 

it 

* * * 

* 

ft * * * 

******* ********* 

* * 

0939 

* 








0990 

* 



EXTERNAL NAMES 



099 1 

* 








0992 

* 

it 

Ik 

* * * 

it 

ft * * ft 

**** *********** 

* * 

0993 

it 








0999 




EXTP 


BEGIN! 

BEGIN TASK SERV.1CE 


0 9 95 




EXTR 


End : 

END TASK StRVICE 


0996 




EX TR 


SUBR : 

BEGIN COMMON SUBROUTINE 


0997 




EXTR 


SUBX ! 

END COMMON SUBROUTINE 


0990 




EXTR 


DELAY: 

DELAY SERVICE ROUTINE 


0999 




EXTR 


EOF ! 

END OF FILE TASK 


0 9 50 




t X TR 


EUR: 

END OF RECORD TASK 


0951 




EXTR 


eurs r T 

SET STATUS AND END OF RECORD 


0952 




EXTR 


SINT : 

SEI INTERNETS TASK 


0953 




EXTR 


SIU: 

START I/U 


0959 




EXTR 


CKSIJMT 

COMPUTE CHECKSUM TASK 


0955 




EXTR 


FETCH: 

get character 


0956 




EXTR 


tOFCKT 

CHECK FUR ENU-OF-FILE 


0957 




EXTR 


hue FOT 

PUT BYTE T n 1u BUFFER 


0950 




EXTR 


« A I T : 

WAIT EUR DtVlCE 


0959 




EXTR 


EOF u: 

CHfcLK FOR ASCII EOF ('/*’) 
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MACR02 (A2) SJ= CHRDS H0 = IlREAD CHARACTER READ PROCEDURE 


0461 
0462 
0463 
0464 
0465 
0466 
0467 
0468 
0 4 69 
.0470 
0471 
0472 
0475 
0474 
0475 
0476 
0477 
0478 
0479 
0480 
0481 
0402 
0403 
0404 
04 85 
0406 
0407 
0400 
0 4 09 
0490 
0 491 
04 9 2 
0493 

0494 
0 4 95 

0496 000F 9C04 0004 STA 


0 

$ 


a/C0UFF 

1 

«iHEOCN1 

SAVE FOR A RESTART 

3> 

RESTART 

t/CBUFF 

1 

oiCUCHNl 

SET BUFFER ADDRESS TO BYTE 

SET BYTE COUNT TO ONE 

HARROW 

CLEAR RAC* ARROW FLAG 

<i’C' 1 CNT 

CLEAR TRANSFER COUNT 

.dEXCESS 

PROMPT CHARACTERS 

RF AX 

IF NONE 

0 

CHECK FOR » 

i + 2 

IF ONLY ONE 

1 

TWO PROMP1 CHARACIERS 

n'ClMPl 

ADJUST COUNT 

PUT IN MINI-IOH 


****************** ** ******** 


* 

A 

k 

k 

k 

k 

A 

A 

A 

A 

A 

A 

A 


A A 


THIS ROUTINE WILL PROCESS ANY REQUESTS 
TO INPUT FROM A CHARAC FF K UFVICE. 

ALL REQUESTED WILL BE ISSUED FUR UNfc U) 
CHARACTER AT A TIME. 

IF THE TRANSFERRED COUNT CONTAINED IN THF 
CIB IS NEGATIVE THE DEVICE WILL HF. 

PROMPTED WITH THE CHARACTER UR CHARACTERS 
CONTAINED IN THE CTCnT * 

************************* 


0000 




REL 


0000 


I: RE AD 

4. 

EGU 

OOOO 

B4 1B 

0 0 1R 

K 

LD A 

0001 

1350 



LLA 

0002 

9C0E 

0 00E 


STA 


0003 


RFA2 

X 

EOU 

0003 

9C 1 » 

0010 

K 

STA 

0004 

C60 1 



LAP 

0005 

9C23 

0023 


STA 

000b 

0110 



7.AR 

0007 

9C1D 

0010 


STA 

0000 

9C 1C 

00 1C 


STA 

0009 

H4 16 

0016 


LOA 

0 0 0 A 

308E 

0019 


JAP 

00 OR 

1357 



LLA 

oooc 

2101 

000E 


JAZ 

OOOO 

C601 



LAP 

000E 

0150 



1 AH 
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MACRO? (A2) S1 = CH.NDS BU= ItREAD - mm CHARACTER READ PROCEDURE 


0497 

00 1 0 

C 6 0 8 



LAP 

0498 

00 11 

8C1H 

00 18 


ADD 

0499 

00 12 

9C05 

0005 


ST A 

0500 

0 0 13 

FBDC 

0 OF 0 


S1N1 

0500 + 

0014 

23F9 


• 


0501 

0015 

0030 



T X A 

0502 


.0000 



IFF 

0503 

0016 

8 ADA 

OOF 1 


ADD 

0504 





ENUC 

0508 

0017 

FBO A 

0 0F2 


JST 

0509 

0018 

FB.DA 

00F3 


JST 

0510 


00 1 9 


RF AX 

E'JU 

0511 

0019 

F BOb 

UOFO 


SINT 

0511 + 

001 A 

13F9 




0512 

00 IB 

C607 



LAP 

0513 • 

00 1C 

8419 

0019 


AND 

0514 

00 ID 

D203 

0021 


CMS 

0515 

0 0 1E 

F203 

0022 


JMP 

0516 

00 IF 

F 234 

0054 


JMP 

0517 

0020 

F20C 

002D 


JMP 

0518 

0021 

0002 


TWO 

DAI A 

0519 




* 


0520 




* 


0521 




* 

TITL 

0522 




* 


0523 


0022 


UNFMTI 

EQU 

0524 






0525 

0022 

f no l 

0 OF 4 


JST 

052b 

0023 

FDD 1 

OOF5 


JST 

0527 

0024 

3242 

0022 


JOR 

0528 

0 0 25 

F3D0 

0 OF 6 


JMP 


IACRT 

a)C10B ADDRESS OF PROMPT CHARACTERS 
i)CTHPl + l PUT )N HIM-IOH 
STANDARD,OUTPUT » 0 

CIH ADDRESS 

LS I 305 

=CTMP1 ADDRESS OF MINI-IOB 

SIO: DO OUTPUT 

WAIT: FOR DELAY , 

$ 

SIANDARD,INPUT,0 

7 OP CODE MASK 

dCOP MASK OFF OP CODE 

Two COMPARE TO TWO 

UNFMTI UNFORMATTED 

MININ BINARY 

RP A3 FORMATTED asci i 

2 CONSTANT TWO (2) 


UNFMTI - UNFORMATTED INPUT 

1 

FETCH: GET NEXT CHARACTER 

BUFFO: GO PUT INTO BUFFER 

UNFMTI GU GET NEXT CHARACTER 

LOR! END (IF RECORD 
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lljjljj 

"page <>009 
MACK02 (A 2) 


0 9 / U 1 / 7 b 
SI= CHRDS 


0 9": ti > : 
BU = 


i|il||i 

R1 X/IO*' ;:; C 
KF A- 


\\\\\m 

HAKACItK I/O VWmF.NS 93302-1XE0 
HEAD FORMA I TED ASCII 


0530 

0531 


0026 


A 

RFA10 

0532 

0533 

0026 

FbCC 

00F3 

A 

0539 

0027 

B90E 

OOOE 


0535 

0026 

F 625 

0003 


0536 




* 

0537 

0538 


0029 


KFA4 

A 


0539- 0029 9CU) 0010 

0590 002A CODF 


059 1 002B F220 009C 

0592 002C FBC8 OOFS 

0593 * 

0599 002D RFA3 

0595 * 

0596 002D FBC6 00F9 

0597 002E FttCH 00F7 

0598 002F A2C8 00F8 

0599 0030 9C2S 0025, 

0550 0031 COFF 

0551 0032 F605 0021) 

0552 0033 D2C5 00F9 

0553 0039 F607. 002D 

0559 0035 F60C 0029 

0555 * 

0556 * 

0557 * 


E'JU 

S 


JST 

WAIT; 


IDA 

<t)REOCNT 


JMP 

RFA2 

GO RESTAR1 

EQU 

$ 

MAYBE GOOD 

STA 

nlARROW 

SET FLAG 

C A I 

- :OF 

IS IT BACK ARROW? 

JMP 

RFA9 

YES, BACK UP 

JST 

BUFFO: 

PUT INTO BUFFER 

EOU 

S 

LOOP 

JST 

fetch: 

GET CHARACTER 

JST 

EOFCK; 

IF FILE MARK, GOODBYE 

10 R 

= :60 


STA 

5ICDCHN3 

HIGH-OWOEK BIT ON 

C A I 

: f f • 

IS IT RUBOUT? 

JMP 

H F A 3 

YES, IGNORE IT 

CMS 

= :au 

HOW ABOUT A CARRIAGE RETURN? 

JMP 

HFA3 

TOO SMALL 

JMP 

RFA9 

GOT A LIVE ONE 

FOUND 

CARRIAGE 

RETURN 













PAGE 0005 09/01/76 09:47:37 RTX/IOX CHARACTER I/O DRIVERS 93302-1XE0 


M A C R 0 2 

( AP) 

Sis 

CHNDS 

HO s 


RF A- 

READ FORMATTED ASCII 

0559 




* 




0560 




* 

FOUND 

CARRIAGE 

RF TURN 

0561 




A 




0562 

0036 

C604 



LAP 

PROMPT 

PRUMPTAHLE BIT 

0563 

0037 

84 IF 

0 0 1 F 


AND 

o»CFUN 1 

IS IT? 

056<l 

0038 

2 IOC 

0045 


JAZ 

RF A 1 

IF NOT , GFT OU1 

0565 

0039 

C603 



LAP 

EORMSK 

MASK FOR EOR TYPE 

0566 

003A 

8 4 1 F 

00 1 F 


AND 

nlCFUM 1 

GET EOR TYPE 

0567 

003B 

C 0 02 



C A I 

2 

IS IT CR/LF ? 

0566 

003C 

F 20 1 

003E 


J HP 

i + 2 

YES, ECHO LINE FFIED 

056 9 

0030 

F20 7 

0045 


JMR 

RF A 1 

NO, FORGET LINE FEED 

0570 

UO 3E 

FBB4 

0 OF 3 


JST 

vs A I T: 

DO A HICCUP 

0571 

003F 

FBBO 

OOFO 


SINT 

STANDARD 

,OUTPUT,0 

057 U 

00*10 

23F9 






0572 

00*11 

B250 

0092 


LI) A 

CRLF+1 

LINE FEFD 

0573 

00*12 

9C25 

0025 


STA 

n)CDCHN3 

DATA CHARACTER 

057*1 

00*13 

B4 22 

0022 


LDA 

nlCDCHN 

POINER TO MINI-10B 

0575 

004*1 

FBAD 

00F2 


JST 

SIO: 

OUTPUT 

0576 




* 




057 7 


0045 


RF A 1 

EQU 

* 

CHECK FOR VALID RECORD 

057 n 




A 




0579 

0045 

ucio 

0010 


EMA 

o'ARROW 

correction FLAG 

0560 

0046 

CODF 



C A 1 

! I)F 

LAST CHARACTER BACK ARROW 

0 50 1 

0 0 '1V 

r 621 

o 

o 

."U 


JMP 

RF A 10 

YFS, no IT OVER 

05B2 

004 8 

04 OF. 

00 OF 


LDA 

dlREOCNT 

RESTART ADDRESS 

0503 

0049 

1 3D0 



LRA 

1 

HAKE IT WORD 

0500 

004 A 

9C10 

00 1B 


STA 

niCUUFF 


0505 

004B 

F3AE 

OOF A 


JMP 

EUFO: 

CHECK FOR END OF FILE 

0586 




A 




0587 


004C 


HFA9 

Ef)U 

.3 

BACK ARROW FOUND 

Q58B 




A 




0589 

0 0 4C 

B41C 

00 1 c 


LDA 

a'CTCNT . 

CURRENT COUNT 

0590 

0041) 

2160 

002D 


JAZ 

RF A3 

IF AT BEGINNING 

0591 

004E 

0000 



DAR 


DOWN ONE 

0592 

004F 

9C1C 

00 lC 


SI A 

mCTCNf 

RESTORE IT 

0593 

0050 

84 1B 

0018 


LDA 

aiCBUFF 

*' * 

























fre^e/ii 



PAGE 

0 0 0 6 

09/01/76 

09:a7:37 

MACRU2 

( A2) 

SI = 

CURDS 

BU = 

059a 

0 051 

00DO 


DAR 

0595 

0052 

9C1B 

0 0 1 B 

ST A 

0596 

0053 

F b?b 

002D . 

JMP 



RTX/IOX CHARACTER I/O ORIVFRS 93302-1XE0 
RFA - READ FORMATTED ASCII 



* DECREMENT BUFFER ADDRESS 
o>CBUFF * * 

RFA3 GO GET NEXT 


Si 
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MACR02 (A?) Sl= CHRDS B0 = 


0598 

0599 

0600 

0601 

0602 

0603 

0604 

0605 

0606 

0607 

0608 

0609 

0610 

0611 

0612 

0613 

0614 

0615 

0616 

0617 

0618 

0619 

0620 

0621 

0622 

0623 

0624 

0625 

0626 

0627 

0628 

0629 

0630 

0631 

0632 

0633 


RTX/IOX CHARACTER I/O DRIVERS 93302-1XE0 
HININ - INPUT BINARY ROUTINE 





* 

READ 

A BINARY 

RECORD 




* 

find 

THE RECORD HEADER 


0054 


BIN1N 

EOU 

S 


0054 

FB9F 

0 OF 4 


JST 

FETCH: 

GET A CHARACTER 

0055 

COFF 



C A I 

: FF 

IS IT A RUdOUT 

0056 

F202 

0059 


JMP 

J + 3 

YES GO GET BYTE COUNT 

0057 

Frt9F 

0 OF 7 


JST 

F.OFCK! 

CHECK FOR /* 

0058 

F 604 

0054 

4. 

JMP 

HININ 





* 

▲ 

GET 

THE BYTE COUNT 

0059 

0 110 


n 

ZAR 


* . . 

005 A 

9C0D 

OOOD 


STA 

accsuM 

CLEAR THE CHECKSUM 

005B 

FB98 

00F4 


JST 

FETCH: 

GET FIRST CHARACTER 

O0SC 

1 357 



LLA 

8 

SHIFT TO HIGH ORDER BYTE 

0050 

9C1D 

00 ID 


STA 

SCO AA 

SAVE IN TEMP CELL 

005t 

FB95 

00F4 


JST 

FETCH: 

GET SECOND CHARACTER 

005F 

A4 ID 

00 ID 


I OR 

SCDA A 

MERGE THE TWO ETYTES 

0060 

3101 

006? 


JAN 

$ + 2 ' 

NOT AN END OF FILE 

0061 

F 399 

0 OF B 

4. 

JMP 

EOF : 

AN END-OF-FILE 




* 

READ 

THE INPUT 

DATA 

0 0 6? 

0310 



NAR 



0063 

9C0E 

OOOE 

A 

STA 

aWEQCNI 

SAVE REQUIRED COUNT 


0064 


n 

NEXT 1 

EOU 

$ 

GET NEXT ONE 

0064 

FB8F 

00F4 


JST 

FETCH: 

GO GET NEXT BYTE 

0065 

FB8F 

OOF5 


JST 

BUFFO: 

GO MUFUE INTU BUFFER 

0066 

DCOE 

OOOE 


IMS 

oiREUCNT 

INCREMENT NUMBER UF BYTE: 

0067 

F60 3 

0064 


JMP 

NEX r 1 



PERFORM CHECKSUM 


0066 C6FF 




























II/3-36 


mill 




!';!!!!•#* 
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mm . 

'PAGE 

0008 

09/01/76 

09*uT:7T 

RTX/IOXCHARACTFP 1/U Otj'mRS 93302-1XE0 

MACR02 

(A2) 

Sis 

CHRUS 

B0 = 

BININ -- 

- INPUT BINARY RUIJ11NE 

0634 

0069 

8400 

0000 

AND 

'JCCSUH 

MASK OFF LOR ORDER BITS 

0635 

006A 

9C 11) 

00 ID 

ST A 

rtCDAA 

SAVE RECORD CHECKSUM 

0636 

0 06B 

Ft3B 8 

O0F4 

JST 

fetch: 

FIRST BYTE 

0637 

0 06C 

1 357 


LLA 

8 

SHIFT TO HIGH ORDER BYTE 

0638 

0060 

9C OF 

0 0 0 F 

ST A 

aREQCNT 

SAVE 

0639 

006E 

F BB5 

0 OF 0 

JST 

fetch; 

SECOND CHARACTER 

0640 

0 0 OF 

A 0 OF 

OOOE 

1(1R 

nlREUCNT 

MERGE TWO BYTES 

0641 

00 70 

9 u 11) 

00 1U 

SUB 

<vC I) A A 

SUBTRACT COMPUTED CHECKSUM 

06^2 

0071 

2101 

00 7 3 

JAZ 

$ + 2 

IF EVERYTHING OK 

0643 

0072 

B289 

OOFC 

LD A 

=ERROR 

ERROR CODE 

0644 

0073 

F 389 

OOFD 

JMP 

EORST: 

ERROR EXIT 

















II/3-37 
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MACR02 (A2) SI= CHRDS B0= I:WlTE —- CHARACTER WRITE PROCEDURE 


0609 




* 

it * * 

* * 

* it it if it 

************** 

0650 




* 





0651 




* 


THIS 

ROUTINE WILL PROCESS ANY REQUESTS 

0652 




* 


TO OUTPUf TO A 

CHARACTER DEVICE. 

0653 




* 





0650 




* 


AFTER 

THE REQUEST HAS BEEN STARTED* CONTROL 

0655 




* 


WILL 

HE RETURNED TO THE 10 SCHEDULER 

0656 




* 





0657 




* 

* * * 

-* * 

* * ■* * * 

************** 

0658 




* 





0659 


0070 


I 

SHITE 

EUU 

$ ' 


0660 




* 




* 

0661 

0070 

FB70 

OOF 0 



SINT 

STANDARD 

,OUTPUT,0 

0661 + 

0075 

23F9 







0662 

00 76 

B 0 1 A 

00 1 A 



LD A 

NCRCNT 

REQUESTED COUNT 

0663 

0077 

9C1C 

001C 



STA 

4CTCNT 

SET TRANSFEREf) COUNT 

0660 




* 





0665 




* 

WHAT 

WAS 

REQUEST 


0666 




* 





0667 

0078 

C603 




LAP 

3 

• 

0668 

0079 

8019 

0019 



AND 

<i>COP 

MASK OFF OP-CODE ; 

0669 

007 A 

90 9 

00 19 



STA 

n>COP 

REPLACE NEW ONE 

0670 

0076 

C003 




C AI 

3 

IF BINARY 

0671 

0 0 7C 

F21E 

0096 



JMP 

HI TE10 

FORMATTED BINARY 

0672 

00 7D 

0030 




1 XA 



0673 


0000 




IFF 

LSI305 


0670 

007E 

8A7F 

OOF E 



ADD 

=CRCHT 

ADDRESS OF OATA CHAIN 

0675 






ENOC 



0679 




* 





0680 


007F 


RITE! 

EOU 

$ 

DUII TUIT 

0661 




* 





0682 

007F 

F672 

00F2 



JST 

SIO: 

START I/O 

0683 

0080 

B019 

0019 



LOA 

otCOP 


0680 

0081 

C001 




C A I 

1 

IF UNFORMATTED 

0685 

0082 

F373 

OOF 6 



JMP 

EOR t 

GO TO END UF RECORD 


0686 * 
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001 0 

09/01/76 

09:<rr: 

37 

PTX/IOX CHARACTER J/Cl DRIVERS 9330?-JXEO 

MACKU2 (A2) 

Sl = 

CHKOS 

80 = 


1; RI T E 

- CHARACUR WRIfE PROCEDURE 

0687 




* 

OUTPUT TRAILER 

RECORD 

0688 




* 




06H9 


0083 


RITE? 

EOU 

$ 


0690 

0083 

F8 6F 

0OF 3 


JST 

WAIT: 

WAIT AWHILE 

0691 

0080 

C603 



LAP 

EORMSK 

END OF RECORD MASK 

069? 

0085 

80 1 F 

00 IF 


AND 

nJCFUNl 

MASK OFF THE EUR FLAG 

0693 

0086 

9C1H 

0018 


SI A 

niCBUFF 


0690 

0087 

8A08 

0090 


ADI) 

f.ORHAI) 

ADD START OF BUFFER ADDRESS 

0695 

0088 

BC1B 

0018 


EM A 

a'COUFF 

PUT IT AND PICK UP FOR FLAG 

0696 

0089 

1300 



LRA 

1 


0697 

0 0 8 A 

0150 



I AR 


CORRECT A OF CHARACTERS 

0698 

8088 

9C l A 

0 0 1 A 


ST A 

rfCRCN r 

PUT INTO DATA CHAIN 

0699 

008C 

0 0 30 



TXA 



0700 


0000 



IFF 

LS I 305 


0701 

O08D 

8 A 7 0 

OOFE 


ADD 

=CRCNT 

DATA CHAIN ADDRESS 

0702 





ENDC 



0706 




* 




0707 


0 0 8E 


LEAVE 

EQU 

4 

CALL SIO: AMD GO TO EOH: 

0 7 08 




* 




07.09 

008E 

FB63 

00F2 


JST 

Sin: 

START I/O 

0710 

006F 

F366 

OOF 6 


JMP 

EUR: 

ALL DUNE 

0711 

0090 

0 091 


EORBAD 

DATA 

CRLF 


0712 

0091 

8DB A 


CRLF 

DATA 

:8U8A,: 

8A8U,:8D8A,:A08D 


0092 

8A80 







0093 

BUB A 







0090 

A 081) 






0713 

0095 

0 00 0 


NULLS 

DATA 

0,0,0 



0 096 

00 00 







0097 

0000 






0710 

0098 

FFOO 


EOF t 

DATA 

:FF 00,0 



0099 

0000 






0715 

0 9 9 A 

AF AA 


EOF? 

TEXT 

•/*' 


0716 




* 




0717 


0098 


RITE10 

EOU 

$ 

FORMATTED BINARY 

0718 




A 




0719 

009B 

0110 



ZAP 
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MACRH2 (A2) SI= CHRDS 8U= 


0720 

009C 

9C0D 

OOOD 


SI A 

0721 

0090 

H21 4 

0062 


LOA 

0722 

009E 

FB53 

00F2 


JST 

0723 

009F 

FI353 

OOF3 


JST 

0724 




k 


0725 


00 AO 


RITE11 

EOU 

0726 




k 


0727 

00 AO 

841 A 

00 1 A 


LDA 

0728 

0 0 A 1 

9C25 

0025 


STA 

0729 

Q0A2 

C602 



LAP 

0730 

00A3 

9C2 3 

0023 


STA 

0731 

00 A 4 

B422 

0022 


LDA 

0732 

0 0 A 5 

FA2E 

00D4 


JST 

0733 

00A6 

F64H 

00F2 


JST 

0734 

00A7 

FB4B 

0 0F3 


JST 

0735 




k 


0736 


00A8 


KI1E12 

EUU 

0737 




k 


0738 

0 0 A 8 

0030 



1 X A 

0739 


0000 



IFF 

0740 

00A9 

8 A 54 

OOFE 


ADO 

0 7 4 1 





ENDC 

0745 

OOAA 

FA29 

0004 


JST 

0746 

OOAB 

F6 46 

00F2 


JS r 

0747 

0 0 AC 

F 8 4 6 

00F3 


JST 

0748 




k 


0749 


0 0 AD 


RITE13 

EQU 

0750 




k 


0751 

0 0 AD 

C6FF 



LAP 

0752 

OOAE 

840U 

OOOD 


AND 

0753 

00 AF 

9C25 

0025- 


STA 

0754 

0060 

8422 

0022 


LDA 

0755 

0081 

Fb23 

008E 


JMP 

0756 

0 082 

0083 


RHEDAD 

DATA 

0757 

0083 

0005 


RHEAD 

DATA 


0084 

0096 





R1X/IOX CHARACThR 1/0 DRIVERS 93302-1XE0 
lJRITE - CHARACTER WRITE PRULEUURE 

nJCCSUM CLEAR THE CHECKSUM BYTE 

RHEDAD RECURD HEADER TASK 

SIOJ START 1/U 

WAIT: WAIT AWHILE 

S OUTPUT BYTE COUNT 

*CRCNT REQUESTFD COUNT 

nJCDCHNi PUT INTO C 1 8 

2 . TRANSFER COUNT 

SC0CHN1 PUT INTO DATA CHAIN 
nlCDCHN DATA CHAIN ADDRESS 

I: UCS GO COMPUT CHECKSUM 

SIOJ START 1/0 

WAIT: WAIT AWHILE 

i OUTPUT BINARY RECORD 


LSI 305 

=CRCNT DATA CHAIN ADDRESS 

ItOCS COMPUTE CHECKSUM 

S10: START I/O 

WAIT: WAT 1 A HU 

* OUTPUT CHECKSUM 

: F F 

W)CCSUM MASK OFF CHECKSUM 

mCUCHN3 PUT INTO C 16 

'VCDCHN DATA CHAIN ADDRESS 

LEAVE LEAVE RFCA.USE YOU'RE DONE 

RHEAD 

5rNULLS+1 























II/3-40 
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HACR02 (A2) SI= CHRUS BO= I : FUN FUNCTIONS 


0799 

OOCA 

FB2 / 

0 OF ? 


JST 

sio: OUTPUT 

6 NULLS 

0795 

OOCB 

DC 1 6 

00 16 


IMS 

^EXCESS ARE 

WE 

DONE 

079b 

OOCC 

FbO 9 

00C8 


JMP 

$-0 NO 



0797 

OOCU 

F32B 

OOFb 


JHP 

EUR: JHP 

END 

OF RECORD 

0790 

OOCF 

OOCF 


LEADER 

DATA 

$♦1/6r NULLS 




OOCF 

0006 








0000 

0095 







0799 


0002 


FEOF 

EUU 

RHFOAD 



0800 

0001 

0 0D2 


SEOF 

DATA 

S+ 1 ,2,E0F2 




0002 0002 
0003 009A 
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PAGE 001 t! 09/01 /1b Q^fkrfn RTX/lijk CHARACTER 1/tl'MlVEHS 93302-1XE0 
MACRO? (A?) SI= CURDS OU= 1 S 0 C S —- OUTPUI CHECKSUM 


0802 
0803 
0809 
0805 
0806 
080 7 
0 808 
0809 
OHIO 
081 1 
0812 
0813 
0814 
0815 
0816 
0817 
0818 
0819 
0820 
0821 
0822 
0823 
0824 
0825 
0026 
0027 
0828 
0829 
0830 
0831 
0832 
0833 
0834 
0 8 35 
0836 
0837 


******** ****************** 
* 

* THIS ROUTINE WILL SEARCH THRU THE OUTPUT 

* DATA CHAIN AND CREATE THE CHECKSUM FOR 

* 1HF ENTIRE CHAIN 

* 

* CALLING SEQUENCE: 

* 

* jst i:ocs 

* 

* A REGIS1ER MUST CONTAIN THE ADDRESS OF 

* THE FIRST PORTION OF THE CHAIN 

* THE CHECKSUM IS TO RE COMPUTED 

* X REGISTER MUST CONTAIN THE CIB ADDRESS 

* 

* RETURN STATUS: 

* 

* A REGIS IER CONTAINS A 8 BIT CHECKSUM 

* X REGISTFR UNCHANGED 

* STATUS: 

* OVERFLOW - RESET 

* REMAINDER IS unchanged ■ 

* 

* THE COMPUTED CHECKSUM IS PLACED BACK IN 

* THE CIB 

* 

************************** 

* 


OOD4 

0800 


ItUCS ent 



0 0D5 

9 A 1 8 

OOEE 

STA 

1 MP3 

SAVE DATA CHAIN ADDRESS 

0 0 0 6 

E A 1 6 

0 OEM 

STX 

TMP2 

SAVE CIB ADDRESS 

OOD7 

B40D 

OOOD 

LDA 

n'CCSUM 

CHECKSUM BYTE 

0 008 

9 A 0 A 

00E3 

STA 

TI0CS5 

INITIALIZE CHECKSUM 

00D9 

Bil 4 

OOEE 

LDA 

* T HP3 

NUMBER OF BYTES IN RECORD 

OOOA 

(1310 


NAR 



0 ODB 

9 A 1 3 

OOEF 

STA 

COUNT 

SET BYTE COUNTER 


* * 




















RTX/IOX CHARACTER I/O DRIVERS 93303-1XE0 
I : 0 C S - OUTPUT CHECKSUM 

T MP3 BUMP CHAIM POINTER 

* TMP3 BUFFER ADDRESS 

1 SET TO BY 1E ADDRESS 

* COMPUT CHECKSUM FOR NEXT 

SET BYTE MODE 
<i>0 LOAD OUTPUT BYTE 

SET WORD MODE 

CKSUM: GO COMPUTE CHECKSUM 

S-J CHECKSUM DATA CELL 

INCREMENT. BUFFER ADDRESS 
COUNT INCREMENT COUNI DONE 

IiOCSa NOT DONE 

$ ALL DONE SO CLEAN HOUSE 

IJ OCS5 COMPUTED CHECKSUM 

TMP2 RESTORE X REGISTER 

o'CCSUM PUT CHECKSUM IN CIB 

1 MP3 

RESTORE A REGISTER 
I IOCS RETURN 
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' 1 i! PAGE OOJb 0 9 / 0 1 / 7 b 09:^7:37 RTX/lOX 

MACR02 (A2) Sl= CHRDS HO= I : (I 

00F9 GOOD 
OOFA 0000 
OOF* 0000 
OOFC 0000 
OOFD 0000 
UOFE 00 1 A 
OOFF 0000 

0065 END 

0000 ERRORS 
0000 WARNING 


til|!!Q 

CHARACTER T/UDWIVEKS 93302-1XE0 
C S - OUTPUT CHECKSUM 



) 
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PAGE 

0001 

09/01/76 

09:50 

:90 

RTX/IUX CHARACTER 

U 

0000 

ARROW 

Oa80* 

0539* 

0579* 



X 

onoo 

BEGIN: 

Oaaa 






0600 

B I N I N 

0516 

0605 




X 

0000 

BUFFO: 

0057 

0526* 

0592* 

0627* 


U 

0000 

CBIJFF 

0978 

0989* 

0509* 

0593 

0595* 

U 

0000 

CCSUM 

0610* 

0639 

0720* 

0752 

0033 

U 

0000 

CDA A 

0613* 

0615 

0635* 

0691 


U 

0 0 0 0 

CDCHN 

057a 

0731 

0759 



U 

0000 

CDCHN1 

0906* 

0730* 




u 

0000 

C0CHN3 

0596* 

0573* 

0728* 

0753* 


u 

0000 

CFUN1 

0563 

0566 

0692 

0700 


u 

0000 

Cl OB 

0996 





X 

oooo 

cksum: 

0959 

0097* 




u 

0000 

COP 

0513 

066H 

0669* 

0603 

077i 


0063 

COUNT 

0837* 

0050* 




u 

oooo 

CRCNT 

0662 

0679 

067 7 

0696* 

07u 1 




0793 






0712 

CRLF 

0572 

071 1 




u 

oooo 

CTCnJ 

0909* 

0509 

0592* 

0663* 


u 

oooo 

CTMP1 

0996* 

0999* 

0503 

0506 


u 

oooo 

D 

05 0 0 

051 1 

0571 

0661 

0760 

X 

oooo 

DELAY: 

0990 





X 

oooo 

END:' 

0995 






07 la 

EOF 1 







0/15 

E0F2 

0000 





X 

oooo 

EOF: 

0999 

0617 




X 

oooo 

EOFCK: 

0956 

0597* 

0609* 



X 

oooo 

EOFO! 

0959 

0505 




X 

oooo 

eor: 

0950 

0520 . 

0605 

0710 

07 76 


0/11 

EORHAD 

Ob99 





u 

oooo 

EORHSK 

0565 

0691 




X 

oooo 

EORST: 

0951 

0699 




u 

oooo 

ERROR 

0693 





u 

oooo 

EXCESS 

0990 

0791* 

0795* 




0 799 

FEOF 

0705 





X 

oooo 

FETCH: 

0955 

0525* 

0596* 

0601* 

0611* 


0639* 


1/0 l'91 vFI’S 933U2-IX 


0693* 0695* 
0057* 


0771* 

0700 0727 0700 


0797 


0 614* •iSf'o* i'M * 







I 


00 0 2 09/01 /76 09*.-5 


h rx/iox !| Iimaracte*' 


v I » 


0778 
0766 
0830 
0802 
0808 
0853 
0076 
0659 
0000 
0 0 00 
0798 
0707 
0000 

0620 
0713 
0000 
07B8 
0 0 00 
0000 
0577 
0531 
0082 
0500 
0537 
0587 
0510 
0 757 
0756 
0680 
0717 
0725 
0736 
0709 
0689 
0800 
0000 


F M ARK 
1: FUN 
I IOCS 

I tocso 
1:0CS5 
I:0C39 
1 ‘.READ 
IJR1TE 
I A C N T 
INPUT 
LEADER 
LEAVE 
LSI 305 

NEXT 1 

NULLS 

OUTPUT 

PLEAD 

PROMPT 

REUCNT 

KF A 1 

RF A 1 0 

WF A 2 

RFA3 

RF AO 

RFA9 

RF AX 

RHEAO 

RHEUAD 

HI TE1 

RITE10 

RITEU 

RITE12 

RITE13 

RITE2 

SEOF 

SINT: 


0/7 3 

0036 

0732* 

0851 

0830* 

0 0 30 
0035 
0097 
051 1. 
0793 
0 755 
0502 
0/02 
0629 
0757 
0500 
0775 
0562 
0 0 80* 
' 0560 
05*1 
0535 
0517 
0550 
0501 
0 0 9 1 
0756 
0721 

0780 
067 1 


0037 

0782 

0052 


0705* 0860 


0855 


0505 0605 0673 0676 070" "70s 


0798 . 

0571 0661 0768 


0530 0582 0622* 0b28* 063** , 

0569 


0551 0553 0590 0596 


0799 




PAGE 0003 09/01/76 (>9i50:08 


RTX/IUX CHARACTER I/O DRIVERS 93302-1X 


X 

ooou 

SIUJ 

0053 

0508* 




0786* 

0799* 

u 

0000 

S TANDA 

0500 

0511 

X 

0000 

SUHR! 

0 <186 


X 

0000 

SUHX: 

0087 



0861 

TMP2 

0832* 

0856 


0862 

TMP3 

0831*. 

0835 


0518 

TWO 

0519 



0523 

UNFMT I 

0515 

0527 

X 

0 0 0 0 

WAIT: 

0958 

0792* 

0509* 


0575* 0682* 0709* 0722* 0733* 0796* 
0571 0<5151 0768 

0838* 0839 0858 

0533* 0570* 0690* 0723* <»7 39* 0707* 


0865 SOURCE LIMES 







f 
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DEVICE INFORMATION BLOCK 


JANDARD 
NAME * 

CHAIN 

DCIB 

QUEUE 

CN 

DSW 

DT 


jl/JEL 

DFUN 

DULS 
dC AC 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 word 

DIB CHAIN ADDRESS 0 

CIB ADDRESS 1 

USED BY IOX TO QUEUE REQUESTS 2 

COORDINATION NUMBER 3 

DEVICE SPECIFICATION WORD 4 

DEVICE NAME 5 \ IC 


CONTROLLER NUMBER 
INPUT RTC TICKS 


UNIT NUMBER 
OUTPUT RTC TICKS 


MAX BYTES-ASCII 


MAX BYTES-BINARY 


5 » IOB 

Words 1 

6 and 2 


FUNCTION 

FUNCTION 

FUNCTION 

FUNCTION 

FILE 

PF 

END OF 

CODE 

CODE 

CODE 

CODE 

MARK 

RECORD 


HARDWARE ERROR COUNT (except MTIC) 




ComputerAutocnction 


4.2 REGULAR DIB CONFIGURATION (ALL HANDLERS) - WORDS 0 TO 10 

Word 0 Chain pointer to next DIB (CHAN directive). Last DIB contains 0. 

The DIB CHAN operand is X::. 

Word 1 Associated CIB address. (See list of standard CIB names at the end 

of Section 4.) 

Word 2 Used by IOX as a pointer to queue requests for this DIB. Initialize 

to zero. 

Word 3 Device coordination number. Initialize to zero. 

Word 4 Device Specification Word (DSW) . Each of the 16 bits corresponds to 

the equivalent binary value described for bits 0-3 of IOB Word 5 
(opcode); e.g., if the device is capable of reading Formatted ASCII 
(which function, if requested by the IOB, would appear as 0010 in 
bits 0-3 in IOB Word 5) then bilj 2 should be set on in the DSW. If 
the device can punch leader (1101 in bits 0-3 in IOB Word 5) , then 
bit 13 (:D) should be set on in the DSW. 

Word 5 Device Name. These words are copied into IOB words 1 and 2, respective- 

and 6 ly, upon finishing a call to 10s. These words contain four ASCII 

characters. Word 5 contains the first two characters which specify 
• the device ( M CR" for card reader, fpr example). Word 6 uses the 
following format for the third and fourth characters: 


» M II 1211 10 I J 7 • I 4 1 2 10 



Unit number (beginning 
with ASCII 0) 
Controller number 
(beginning’ with 
ASCII 0) 



For Fortran tasks using the teletype or lineprinter as a list device 
with carriage control character recognition, or for a disk with end-of- 
file capability, the third character of the device name must be ai) , *F M , 
to serve as a flag that the Fortran handler is to be used. 
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Word 7 


C°mputarAiitomatkm 


This word uses the following format: 

15 14 13 12 11 tO • • 7 5 # 4 3 2 1 0 




RTC ticks after EOB 
(output) 

RTC ticks after EOB 
(input) 


Word 8 


Bits 8-15. A binary value representing the number of Real-Time Clock 
ticks to delay after an end-of-block interrupt for an input operation, 
before the device is considered available for the next I/O operation. 

Bits 0-7. ' A binary value representing the number of Real-Time Clock 
ticks to delay after an end-of-block interrupt for an output operation 
before the device is considered available for the next I/O operation. 

This word contains function codes which are executed in Select instruc¬ 
tions to initiate an I/O operation if SIO: is called. 


The order of execution of the Select instruction within SIO: is; 


DA, X 
DA, 5 
DA, 6 
DA, Y 


This word uses the following format: 


15 14 13 12 11 10 5 8 7 5 5 4 3 2 1 0 




End of record action 

Prompt flag 

File mark indicator 

Function code Y 
(output) 

Function code X 
(output) 

Function code Y 
(input) 

Function code X 
(input) 
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Word 9 


ComputorAutomadon (f^ 


Bits 13-15. Contains function code X in the above sequence, for an 
input operation. 

Bits 10-12. Contains function code Y in the above sequence, for an 
input operation. 

Bits 7—9. Contains function code X in the above sequence, for an 
output operation. 

Bits 4-6. Contains function code Y in the above sequence, for an 
output operation. 

Bit 3- A flag signifying the type of file mark to be used for the 
device- 

1 » slash/asterisk 
0 =* rubout/nll/null 

Bit 2. A flag signifying whether the device is to be prompted before 
an input operation. 

I ** Prompt the device 

0 =* Do not prompt the device 

Bits 0-1. These bits represent the end of record action to be taken 
for Formatted ASCII output: 

00 = Output carriage return only 

01 = Output line feed only 

10 = Output carriage return and line feed 

II = Output space and carriage return 


I WOTg I 

Word 8 is set to zero for Distributed I/O and Disk DIB's. 
This word uses the following format: 


18 14 13 12 11 10 t • 7 8 5 4 3 2 1 0 


l 1 t }-.1 1 1 

J 1 1 I 11 1 




A 4 


Maximum record 
(ASCII I/O) 
Maximum record 
(Binary I/O) 


size 

size 


Bits 8-15. Maximum record size (in bytes) for formatted ASCII I/O 
operations. (Zero signifies unlimited record size.) 

Bits 0-7. Maximum record size (in bytes)'for binary I/O .operations. 
(Zero signifies unlimited record size.) 
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Cumulative hardware error count (must be incremented by the individual 
handler). Initialize to zero. 


Word 10 is used differently by the Magnetic Tape Intelligent Cable 
DIB. See the additional DIB configurations section. 


4.3 ADDITIONAL DIB CONFIGURATIONS - UP TO 18 WORDS/ 

Thq following DIB configurations require additional words which are not required in 
the regular DIB configuration. 

4.3.1 Distributed I/O DIB 





«c 
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Word 11 


DIO command fields. This word uses the following format: 


IS 14 

13 12 

it » • * 

7 1 

S 4 

3 2 

1 0 

L_ 

J-1- 

« ^_1_ 

-1_I 

_1_ 

_1_! 

, , 1 

i 

! 1 

\ 1 

f 


Input mode field 
Input branch address 
Output mode field 
Output branch address 


Bits 15*~12. Branch Address Field of DIO Command Word for output. 
Bits 11-8. Mode Field of DIO Command Word for output. 

Bits 7-4. Branch Address field of DIO Command Word for input. 
Bits 3-0. Mode Field of DIO Command Word for input. 


4.3.2 Magnetic Tape Intelligent Cable DIB 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 word 

0 


i 


REGULAR DIB 
CONFIGURATION 




ITt?T ,_ HARD ERROR 

NOT USED . 

| ERASURES 

HARD ERRORS 

RATE ERRORS 

:FB 

0 

TRANS 

ADDR 

MINIMUM RECORD LENGTH 


9 

10 
11 
12 








word 10 


lord 11 
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Three MTIC error counters. This word uses the following format: 

15 14 13 12 11 10 • • 7 • 0 4 3 2 1 0 



Rate errors 
Hard errors 
Hard error erasures 


Bits 11-8. The number of erasures due to hard errors. 

Bits 7-4. The number of hard errors. This counter is reset whenever 
an erasure occurs. 

Bits 3-0. The number of rate errors. This counter is reset whenever a 
hard error occurs. 

4 

Basic mode select word. This word uses the following format: 


18 14 13 12 11 10 • » 7 t » 4 3 110 

111 1 111 1 I 1 I 0 I 1 l| , , , , 



Binary.transport 
address 

Mode Select 


Word 12 


Examples - :FB00 indicates transport 0 
:FB03 indicates transport 3 

This word contains the minimum record length (in bytes). Records 
smaller than this byte count are considered noise records. CIB word 35 
must specify the word address of a buffer with a size greater than or 
equal to the minimum record length. The standard minimum record length 
for the MTIC handler is 12 bytes. 

Write requests with a byte count less than the minimum record length 
will have additional characters appended to the record until the byte 
count equals the contents of word 12. Blanks are appended to ASCII 
records and zeros are appended to Binary records. 

Read request will return only the number of characters requested. 
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12 


Bits 6-5. Drive Number 

This is the number of the drive attached to the controller. Its range 
is from 0 through 3 inclusive. 


Bits 4-d. Starting Sector 

This is the sector number where the extent is to start. Its range is 
from 0 through the number of physical sectors -1 per track. 

This word uses the following format: 


15 14 13 12 11 lOt • 7 t 54 3 2 10 


1 1 1 1 I 11 

i 1 1 J 1 1 1 




* * 


Starting head 
Number of sectors per 
track 


13 


Bits 15-8. Number of Sectors per Track 

This number defines the number of sectors on each track that this 
extent is to occupy. The sum of the number and the starting sector may 
not exceed the physical number of sectors per track. 


Bits 7-0. Starting Head 

This number defines the starting head number of the extent. Its range 
is from 0 through the number of heads -1 on the disk drive. 

This word uses the following format: 


IS 14 13 12 11 10 § 4 7 5 5 4 3 2 1 0 


n 

1_1_!_1_1_ 1 _ 

, 1 1 t I 1 I t 

: ..1 __ J 



A 4 f 


Starting cylinder 
number 

Sectors per cylinder 
Increments starting 
cylinder number 


Bit 15. If this bit is set, the contents of bits 7-0 are incremented 
by 256. 

Bits 14-8. Number of Sectors per Cylinder 

This number equals the number of sectors per cylinder times the number 
of read/write heads. This is the maximum value of any extent. 

Bits 7-0. Starting cylinder 

This number is the first cylinder that the extent is to, occupy. 
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VER- DRIVE 

IFY NUMBER _ STARTING HEAD 

STARTING SECTOR NUMBER 

STARTING CYLINDER 

NUMBER OF SECTORS 

RECORD NUMBER (FORTRAN ONLY) 

NUMBER OF SECTORS PER TRACK 


NUMBER OF SECTORS PER CYLINDER 
















m 


Word 12 


Word 13 


Word 14 


Word 15 


Word 16 


Word 17 


i 

i 


Bit 15, Verify Flag 

If this bit is set, a verify operation will be performed after each 
write. Two additional attempts will be made to re-write the record 
before the error bit in the status is set. 

Bits 14-11. Drive Number 

This is the number of the drive attached to the controller. Its range 
is from 0 to 15 inclusive. 

Bits 10-0. Starting Head # 

This number defines the starting head number of the extent. Its range 
is from 0 through the number of heads -1 on the disk drive. 

Bits 15-0. Starting Sector 

This is the sector number where the extent is to start. Its range is 
from 0 through the number of physical sectors -1 per track. 

Bits 15-0. Starting Cylinder * 

This number defines the starting cylinder number of the extent. Its 
range is from 0 through the number of physical cylinders -1 on the disk 
drive. 

Bits 15-0. Number of Sectors 

This number is used to detect the end of the extent to allow the IOX 
Storage Module handler to set the end-of-device status if access to the 
last sector of the extent or beyond is requested. This number is equal 
to the number of heads per cylinder times the number of sectors per 
track. 

Bits 15-0. Fortran Record Number 

This word is only required for Fortran to provide a location other than 
the user's IOB to store the record number. 

Bits 15-0. Number of Sectors per Track 

This number defines the number of sectors on each track that this 
extent is to occupy. The sum of this number and the starting sector 
number may not exceed the physical number of sectors per track. 

Bits 15-0. Number of Sectors per Cylinder 

This number defines the number of sectors on each cylinder that this 
extent is to occupy. It is numerically, equal to the number of sectors 
per track times the number of heads per cylinder.* Note that the number 
of heads per cylinder plus the starting head number must not exceed, the 
physical-number of ’ heads on the > drive.. 
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m 


< 


SAMPLE DISK DIB 


JT). 


Tltls DIB defines an extent on disk unit 0 of cylinders; 0 through 10, heads 2 and 3,' 
sectors 0-11; that is, all sectors of the. first, eleven cylinders of the removable^ 
plotter: . 






n 




* 

D:DKXX 



* 


NAM 


D:DKXX 

' 4 . ; DIB NAM 

EXTR 


C: DKO 

CIB Reference 

EQU 


$ * 


CHAN 


X: : 

i Chain link to other DIB's 

DATA 


C:DK0 

CIB Address 

DATA 


0 

IOX temp cell 

DATA 


0 

Coordination number 

DATA 


: 0011 

DSW: Direct access Read/Write 

DATA 


'DK, ’XX 1 

, 4 Device name 

DATA 


0 

EOB delay (none required) 

DATA 


0 

FC's, flags (none required) 

DATA 


0 

J Max record size 

DATA 


0 

Error count 

DATA 


0 

Drive 0, starting sector 0 

DATA 


:C02 

Sectors per track = 12 
Starting head number =* 2 

DATA 


: 1800 

Sectors per cylinder = 24 
Starting cylinder number = 0 

DATA 


: 108 

Sectors per extent - 264 
(24 sectors x 11 cylinders) 


c 

r CONTROLLER INFORMATION BLOCK (CIB) - 38 WORDS (47 WORDS FOR STORAGE MODULE DISK) 


he CIB is used for storing and/or transferring information between IOX and the I/O 
andler. Words 15-19 must contain the described information upon initial entry to 
OX. Words 22-31 have data stored in them while in IOX. All other words are used by 
le standard I/O handlers and IOX routines, but may not be required by the user's 
lecially written handler. Figure 4-2 illustrates the CIB configuration. 



B location and its usage is described below: 

Temp cell. Set to zero by the scheduler to be used for beginning of 
record flag. Set to -1 by IORTN: or SIO: . Set to a number greater 
than zero by an interrupt. 


rd 1 


rds 2-11 


:d 12 

c 


Temp cell. If the subroutine SIO: or EORST: is called, this word 
should contain a SEL DA, 7 instruction where DA=the device address of 
the device being accessed. 

Temp cells. CIB's for standard I/O handlers contain a calling sequence 
to the RTX INTQ: routine, which is executed upon an end-of-block inter¬ 
rupt. (See INTQ: description.) 

Temp Cell. The special function codes from DIB Word 8 are stored here 
by SINT:, and used by SIO: in setting up the I/O select instruction 
sequence. 
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Standard 
Nam* * 

C BOR 
CSEL7 

CTMP1 

CTMP2 

CTMP3 

CEBTSK 

CNEWA 

CNEWX 

CFUN 

CCSUM 

REQCNT 

CJTBL 


CSPLOP 

CDEL 

CINTR 

EXCESS 

CEOF 

Cl OB 

COP 
CRCNT 
CBUFF 
CTCNT 
CDA A 
CO IB 
CFUN 1 
STATUS 
CRTN 

CDCMN 

COCHN1 

CDCMN 2 
COCHN3 

refer to 


CONTROLLER INFORMATION MUJCK 

15 14 13 12 11 10 9 0 7 6 5 4 3 2 1 0 word 

O 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 NOTE* 

TC - T< 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 
38 
37 


the .1/0 Handler listing at the end of'Section 3. 
Figure 4-2. CIB Configuration 


TC FOR SIOi —BEGINNING OF RECORD FLAG 


TC FOR StOi OR KORST: Sll. HA. 7 


JST lNTQi 


DATA $ CALLING LOC 


DATA 0 TEMP 1 

DATA 0 TEMP 2 

DATA * 0 TEMP 3 

DATA TA8K ADDRESS 

DATA PRIORITY FOR QUEUED TASK 

DATA ARBG 

DATA . XREG 

DATA ' P-LOC * CIB ADDRESS 

TC FOR SINTj AND SIOi — PUNCT. CODES (DIB wd 8) 

TC FOR CHECKSUM 

TC 

ENTRY POINT TO READ 

ENTRY POINT TO WRITE 

ENTRY POINT TO POSITION 

ENTRY POINT TO FUNCTION 

ENTRY POINT TO SPECIAL OPERATION 

TC FOR SIO*—WATCHDOG TIMER INSTR. 

TC FOR SINT* AND SIO*—DEVICE WORD INTERRUPT ADOR. 

TC FOR IOX—PROMPT CHARS (108 wd 8) 

TC FOR IOX—EOF, AND FOR MAG TAPE—RETRY CTR 

TC FOR IOX—IOB * '"OR 

TC FOR IOX SCHED—OP CODE AND STATUS (IOB wd 5) 

TC FOR IOX SCHED—REQUESTED COUNT (IOB wd 6) 

TC FOR IOX SCHED—BUFFER AD DR (10® .wd 7) 

TC FOR IOX—ACTUAL BYTE COUNT 

TC FOR IOX SCHED—DIRECT ACCESS ADOR (IOB wd 9) 

TC FOR IOX SCHED-DIB ADDR AND BUSY FLAG 

TC FOR IOX SCHED—FUNCT. COCKS (DIB wd 8) 

~ TC FOR BOR: — STATUS 

• TC FOR SIOi AND WAIT:—RETURN ADDRESSES 

DATA $+1 POINTER TO BYTE COUNT 

DATA 1 BYTE COUNT 

DATA $+1 BUFFER ADDRESS 

DATA 0 1 CHAR INPUT BUFF 

■ -- . . * — - ---. 


X 


ip Call 


II/4-15 




ComputorAutorrurtkxi 


Temp Cell. Used by the standard I/O handlers for a checksum storage 
cell. 


Word 14 


Temp Cell. 


ords 15-18 I OX requires these words to be set up as a jump table to various entry 
points in the I/O handler, as follows: 


Word 15 
Word 16 
Word 17 
Word 18 


Entry point to READ. 
Entry point to WRITE. 
Entry point to POSITION. 
Entry point to FUNCTION. 


If any of the above functions have no meaning to the handler, the cor¬ 
responding cell (Words 15-18) should be zero. 


Word 19 


Entry point to SPECIAL OPERATION. If the handler does not perform a 
special operation, this word should be zero. 


Temp Cell. This cell is assumed by SIO: to be an instruction (e.g., 
LLA or NOP) to be used in calculating the watchdog timer. (See SIO: 
routine description.) 


Word 21 


Temp Cell. SINT: and SIO: routines expect this word to contain the 
device's word interrupt address. 


Word 22 


Temp Cell. Used by IOX to store prompt characters from IOB Word 8, if 
any. 


>rd 23 


Temp Cell. Used by IOX character handler in checking for end of file, 
and by the magnetic tape handler as a retry counter. 


Word 24 


Temp Cell. IOX scheduler routine stores IOB address here. 


Word 25 


Temp Cell. IOX scheduler routine stores IOB Word 5 (op code and sta¬ 
tus) here. 


'ord 27 


Temp Cell. IOX scheduler routine stores IOB Word 6 (requested count) 
here. 

Temp Cell. IOX scheduler routine stores IOB Word 7 (buffer address) 
here. 


Word 28 


Temp Cell. Used by IOX routines to count actual byte transfers. 


Word 29 


Temp Cell. IOX scheduler routine stores IOB Word 9 (direct access ad¬ 
dress) here, if any. 


Word 30 


Word 31 


Temp Cell. IOX scheduler routine stores DIB address here, and later 
uses it for a busy flag. (If non-zero, IOX assumes the device to be 
busy.) 

Temp Cell. IOX scheduler routine stores DIB Word 8 (function codes) 
here. 
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Word 32 
Word 33 

Words 34-37 


Word 34 


CompuMkutomatto 


Temp Cell. Used by FOR: routine f -r storane of status. 

Temp Cell. Used by the SIO: and WAIT: routines to store their leturn 
addresses. 

Temp Cells. Used by the standard I/O handlers as a byte count/buffer 
address/l-character buffer sequence for 1-character I/O calls to 
SIO:. (See FETCH: description.) 


| MOTE | 

MTIC Handlers use CIB words 34 and 35 in the following manner: 

Temp Cell. Used to store the MTIC Hardware Status. This word uses 
the following format: 


II 14 13 12 11 10 « 8 7 8 8 4 3 2 1 0 



Status byte two 
Status byte one 


I Word 35 


Minimum Record Length Buffer Address. This word contains a word 
address of a buffer with a size greater than or equal to DIB word 12. 


4.6 STANDARD CIB NAMES 

' The following table shows the CIB names for all devices for which standard and 
1 non-standard handlers exist within I0X. The J^bel is to be used as the second word of 
| the associated DIB(s). (A table of DIB names shown in section 2 - Unit Assignment 
j Table description.) 


Teletype 

CRT 

High Speed Paper Tape Reader 
High Speed Paper Tape Punch 
Line Printer 
Card Reader 
Disk 

Storage Module Disk 
Floppy Disk 
Magnetic Tape 
IEEE Intelligent Cable 


Non-DIO 

Fortran 

Non-DIO 

DIO 

Fortran 

DIO 

C :TY0 

C:TYF 

C:TYD 

C:TYFD 

C:TY0 

C: TYF 

C:TVD 

— 

C:PR0 

C:PR0 

C:PRD 

C:PRD 

C :PP0 

C :PP0 

C:PPD 

C:PPD 

C: LPO 

C:LPF 

C: LPD 

C:LPFD 

C:CR0 

C:CR0 

— 

— 

C:DK0 

C:DKF 

— 

— 

C: SMO 

C:SMFO 

— 

«r- 

C:FD0 

C:FD0 

— 

— 

C :MT0 

C :MT0 

C:MC0 


— 

— 

C: IEOD 

— — 
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SECTION 5 
FILE MANAGER 


The File Manager provides directory and data management for file-oriented devices. 

The devices supported by the File Manager are the moving head disk and the floppy 
disk. It operates as a driver working in conjunction with RTX/IOX. By using the File 
Manager, an application program may communicate directly with the data files by name, 
independent of the physical medium storing the file. 

All requests for file access are made'through IOX (10:) using Logical Units (LUNs) . 

The File Manager calls standard IOX device drivers using Logical Units for the 
required physical I/O. LUN assignments for files as well as LUNs for use by the File 
Manager for physical I/O are made in the Unit Assignment Table (UAT) . (See Section 2, 
I0B and UAT Organization.) File information (name, file attributes, etc.) is con¬ 
tained in a Device Information Block (DIB) for that file. The file DIB is not to be 
confused with the device DIB described in Section 4 although the first ten words are 
the same. The file DIB is described in this section. 

The File Manager requires that all File-oriented devices be labeled prior to use. 

This involves the creation of a Volume Table of Contents (VTOC) and directories on 
each individual unit to allow later file processing by name. Do not confuse 
"labeling** with the "formatting" of disk packs; .the latter must be done with stand¬ 
alone programs before labeling. The RTX File Label Utility (93324-40A1 and -41A1) 
is a stand-alone program for labeling file-oriented devices. The device labeled using 
this utility is compatible with the Computer Automation OS file format. 


5.1 FILE ORGANIZATION 

File organization in the File Manager is compatible with the Computer Automation OS 
'£> file format. Any file-oriented device accessed through the File Manager must contain 
1 a directory. The directory describes by name all data files which reside on the 
device. The physical medium containing a directory and files is called a Volume. The 
first entry in the directory is the Volume Table of Contents (VTOC) . This entry 
contains information for the File Manager as well as volume name and creation date. 

The remainder of the directory is segmented into file description entries, one for 
each file on that volume. An entry contains the file name, creation date and time, 
and File Manager information such as record size, blgck size and file length. See 
Figure 5-1 for directory structure. Figure 5-2, the Disk Descriptor Table, defines 
the disk partition limits. 

For disk volumes, multiple new file writes are supported through disk partitioning. 

The disk is divided into as many as eight partitions, each of which may have a new 
file open. If a file extends past the end of a partition, the file is linked to the 
next available partition. File linkage is supported for forward sequential reading or 
for positioning only (in either direction). Any number of old files may be open. 

(See Figure 5-3 for file linkage.) 
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Figure 5-1. Disk Directory Structure 
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5.1.1 Sequential File Access 

Sequential file processing is available to the user on the moving head disk and the 
floppy disk. Sequential files are uniquely ordered by the File Manager: Given 
logical record N, the next READ request will always return logical record N+l. A READ 
or WRITE operation automatically advances the file to the next logical record. 

However, records may be accessed out of order by using the POSITION operation. 

The File Manager provides automatic blocking and deblocking of logical records under 
sequential access. All I/O requests access a single logical record whose position in 
the physical record is controlled by the File Manager and need not be known by the 
user. 

If the data security bit is set in the DIB, every sequential WRITE operation on that 
file will cause a directory update on the disk. 

For blocked files, the user must provide a record buffer and a blocking buffer. The 
size and address of each" is in the appropriate DIB and IOB. The record buffer may be 
smaller than the file record size; however, the blocking buffer must be the block size 
^>lus two bytes. 


Pnly a record buffer is required for unblocked files. The record buffer may be 
imaller than the file record size. The user MUST reserve a word (two bytes) at 
address BUFFER -1 that is required for use by the File Manager. 


Random Access 

With the File Manager, random access file processing is available only for disk 

vices. Random files are accessed by physical records; automatic blocking/deblocking 
is not provided. A random file must reside within a single partition. The number of 
-*ata bytes contained in each record is fixed at 512. The medium-capacity disk sector 
1 ize is 512 bytes. When using a floppy disk, four sectors are used for each random 
file record; each sector has 128 bytes. 

Although the record size of a random file is fixed, any number of bytes may be read or 
written. The specified record number is relative to the beginning of the file. 

C 1 NOTE 

The record number is used to test for end-of-file. If more than 512 
^ bytes are written, the sector(s) beyond the end-of-file will be destroyed. 

To access a file in the random mode, the file must have been created as a random file. 
When a new file is opened with the random file type bit set in the DIB, a random file 
is created. When closed, the file size is equal to the largest relative record number 
accessed +1. 


5.1.2 File Opening and Closing 

The File Manager provides automatic file opening. On the first access (read, write, 
position, function) of the file, the File Manager will attempt to open the file. If 
the file name is found in the directory, the open and first access is completed. If 
the file name is not found, a new file is created. When creating a new file, the 
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partition number for placement of the file may be specified in the DIB. If not 
supplied (zero), the File Manager will use the partition having the largest unused 
space. Position to absolute file -1 to close the file. 

5.1.3 File Positioning 



File positioning is provided for use with sequential files. It allows the user to 
access logical records out of sequence. There are four basic types of positioning. 
With each type of positioning a count is specified by the user in the Input/Output 
Block (IOB word 6). (The IOB is defined in Section 2.) 

ftote that counting of records or file marks begins at zero, See Figure 5-4 for 
examples of sequential file positioning. 



£ 


\ 


Absolute by file mark* The count is the number of file marks to skip from the 
beginning of the file. The next READ or WRITE will access the logical record 
following the file mark. Note that a position to absolute zero is equivalent to 
a rewind. Positioning a file to absolute ~L will close the file. If the count 
exceeds the number of file marks in the file, an "end-of-media" status is 
returned with the file positioned after the last logical record. 

Absolute by logical record. The count is the number of logical records to skip 
from the beginning of the file (the count must be positive). If a file mark is 
encountered before the count is exhausted, a "file-mark-found" status is returned 
and the file is left positioned at the file mark. If the end-of-file is encoun¬ 
tered before the count is exhausted, an "end-of-file" status is returned and the 
file is left positioned after the last logical record. 

Relative by file marks. The count is the number of file marks to skip from the 
current file position. A positive count means skip forward; a negative count 
means skip backwards. While skipping forward, if the end-of-file is encountered, 
and "end-of-file" status is returned and the file is left positioned after the 
last logical record. In like manner, when skipping backward, a "beginning-of- 
file" status is returned and the file is positioned at the first logical record. 


4. 




Relative by logical record. The count is the number of logical records to skip 
from the current file position. While skipping forward, if a file mark is 
encountered, a "file-mark-found" status is returned and the file is positioned at 
the file mark. 

For backwards skips, if a file mark is found, a "file-mark-found" status is 
returned and the file is positioned after the file mark. As with relative 
positioning by file marks, the File Manager will not allow the position to go 
beyond the beginning and end of file limits. 


With a normal completion, the actual number of records/file marks skipped is returned 
to the user in IOB word 8. For an error completion, the count returned is the number 
successfully skipped when the error occurred. For a retry, the requested count should 
be set to the REQUESTED count in the IOB minus the ACTUAL count. 



II/5-6 





ComputwAutomatton 


5.1.4 File Functions 

The File Manager provides the functions described below. They are set by the user in 
the IOB (see Section 2). 

Write File Mark This function writes a sequential record (blocked 

or unblocked) that contains a :80 in the first 
byte. When read, this record will cause a file- 
mark-found status to be returned. Note that this 
is a data separator, not an end-of-file. 


Delete File 


Update Directory 


This function sets the file-deleted bit in the file 
DIB and in the directory when the file is closed. 
Note that this does not free the space on the file 
device j it only enables a new file to be created 
with the same name. 

This function causes the directory to be updated 
with the current end of file. This function is 
valid only for new files. This enables the user to 
secure the data without performing a close on the 
file. 
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The number indicates the count supplied by the user. 


ABSOLUTE POSITIONING 
FILE MARK OR RECORD -1 
FILE MARK OR RECORD 0 — 


RECORD 1 


CLOSE FILE 


RECORD 


RECORD 


RECORD 


RELATIVE POSITIONING 


•BEGINNING OF DEVICE 
.FILE MARK -100 


RECORD 3 


RECORD 100. 


FILE MARK 1 


RECORD 


FILE 


FILE MARK -1 


.RECORD -100 


RECORD 


RECORD 


RECORD 


RECORD 


RECORD 


RECORD -1 


START HERE 


RECORD +1 


RECORD +2 


RECORD +100 


FILE MARK 2. 


•'ILE MARK +1 


RECORD 


RECORD 


FILE MARK 3 


FILE 


FILE MARK +2 


RECORD 


RECORD 


FILE MARK 100 


RECORD* 


•FILE MARK +100 
END OF FILE 


Figure 5-4. Sequential File Positioning Examples 
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5.2 TABLE ORGANIZATION 
< 

File Manager may be considered as a "dunany" IOX driver in that it is a "data" 
driver as opposed to a device driver. The File Manager is only concerned with the 
data contained on the device and not the device itself, since the File Manager is 
independent of the file device, it calls a standard IOX device driver to access data 
n the device. These calls are made to IO: using the logical units associated with 
the device. 

Since the File Manager operates under IOX as a driver, it requires the same type 
driver tables (i.e. DIBs and CIBs). If the File Manager was equated to a device 
driver, then a VTOC (directory) would be equivalent to a device controller, and a file 
would be equivalent to a device unit. The File Manager requires that one CIB for each 
VTOC, and one DIB for each file be concurrently active Copen). 

A device containing a VTOC to be accessed by the File Manager must have a unique 
logical unit associated with it. This logical unit is contained in the File Manager 
CIB for that VTOC and is used to access the device. 


Each File Manager DIB must have a logical unit associated with it. 
isf sed by the user to access the file described by the DIB. 


This logical unit 


I real unit associations are made in the Unit Assignment Table (UAT) . A description 
or the UAT, as well as of the Input/Output Block (IOB) that contains the LUN, is given 
in Section 2. 


Figure 5-5 gives an example of a table configuration. In this example, the file 
device is a moving head disk with two platters (unit 0 and unit 1) . Each unit 
contains an independent Volume Table of Contents (VTOC) and file directory for that 

lie standard IOX moving head disk driver requires one controller information block 
C ) C:DKO and two device information blocks (DIBs) DsDKOO and D:DK01 for disk units 
) and 1 respectively. 

he Pile Manager requires two CIBs, C:FMO and C:FMl, for VTOC 1 and VTOC 2, respec¬ 
tively . Since three files are to be active (open) concurrently, three DIBs are 
squired: D:FMOO for FILE 1, D:FM01 for FILE 2 and D:FM02 for FILE 3. 

ich( .le device (VTOC) has a logical unit associated with it which is used by the 
le^nager to access the device (LUN X for VTOC 1 and LUN Y for VTOC 2) . 

J user accesses the files through a standard IOX call to 10: using the logical unit 
sociated with the file DIB. ' (LUN A for FILE 1, LUN B for FILE 2 and LUN C for FILE 3. 

’.1 File Device Information Block (DIB) 

: first ten words of the Device Information Block (DIB) have essentially the same 
ctions for the File Manager as they have for IOX. These standard functions are 
cribed in Section 4, DIB and CIB Descriptions. The functions for words 10 through 
are given below. (Refer to Figure 5-6.) 


Is 0-6 


Standard for IOX. 


s 7-9 


Standard for IOX, but must be set to zero for File Manager. 
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ABSOLUTE RECORD NUMBER 


RECORD SIZE 


BLOCK SIZE 


PHYSICAL RECORDS PER BLOCK 


PHYSICAL RECORD NUMBER 


TOTAL RECORDS 


DIRECTORY ENTRY NUMBER 


CURRENT BLOCK ADDRESS 


BLOCKING BUFFER ADDRESS 


LAST PHYSICAL RECORD 


COMPLETION STATUS 


Figure 5-6. DIB Definition when Used with the File Manager 
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Word 


10 


| Word 11 

( 



Physical I/O error status. The status (word 5) of the physical 
I/O IOB is stored here after each operation. 

File Status word. For old files, all bits are supplied by the 
File Manager from the directory; therefore, all bits of word 11 
are initialized to zero. When creating a new file, those bits 
flagged with an asterisk (*) must be supplied by the user before 
the first; access. The data security bit may be modified at any 
time to enable or disable this function. After the first access 
of a file (new or old), if the file delete bit (15) is set, the 
file will be deleted when the file is closed. Bits 15-13 corres¬ 
pond to the file attribute bits in the directory entry and are 
transferred to the entry when a new file is closed. 


Bit 

15. 

Bit 

14*. 

Bit 

13*. 

Bit 

12. 

Bit 

11. 

Bit 

10. 

Bit 

9. 

Bit 

8 . 


keep file, 1 » delete file 


0 = file open for sequential access 
1 = file open for random access 


Bit 10. 0 = old file, 1 * new file 


0 = current block not modified 

1 = current block modified (blocked files only) 


after each sequential write (unblocked files) or after a block is 
written (blocked files). 

Bit 7. 0 = file not linked, 1 = file linked 

Bits 6-4. Reserved for future expansion. 


Bits 3-0*. Partition number. For old files, contains the number. 
For new files, specifies where the new file is to be created. If 
zero, the available partition with the greatest unused space is 
used and its number is stored here. 


Words 12-14* ASCII file name. Supplied by the user. 

Word 15 Relative record number. Relative to the beginning of the current 

file segment for linked files. With unlinked files, this word is 
the same as the absolute record number. 


Word 16 


Absolute record number. The current file position relative to the 
beginning of the file. Note that the first record is record zero. 




Word 17* 


Record size in bytes. Set to 512 for random files, 
user for new files. 


Information supplied by user. 


(L 


Supplied by 
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C Word 18* 
Word 19 

Word 20 

. Word 21 

Word 22 

Word 23 

r 

J^Word 24* 

( 

Word 25 
Q 'ord 26 



Block size in bytes. Used for blocked files only. Supplied by 
user for new files. 

Number of physical records/block. Contains the number of 512 byte 
physical records required for a file block (blocked files) or 
record (unblocked files). Supplied by the file manager. Referred 
to as "tach ratio" under CAI OS. 

Physical record number of first record in file. Supplied by the 
File Manager. 

Total records in the file. For linked files, contains total 
records in current segment. Supplied by the file manager. 

Directory entry number for this file. Supplied by the file 
manager. 

Current block address. Contains the physical record number of the 
last block read. Supplied by the File Manager. 

Blocking buffer address, (Word address, no indirect). Supplied by 
user when accessing blocked files. Buffer size must be block size 
plus 2 bytes. Not required for unblocked or random files. 

Last physical record in partition. For new files, contains the 
last available record number. Not used for old files. Supplied 
by the File Manager. 

Completion status. Cleared upon entry into file manager and set 
when operation is complete. A bit is active when it is set to 1. 

Bit 15. Physical I/O error. An abnormal status was returned 
from physical I/O. The detail physical I/O status (DHST) word in 
the DIB contains word 5 of the CIB IOB used for the physical I/O. 

Bit 14. Device not labeled. A valid VTOC identifier was not 
found. This error can only occur during a file open. 

Bit 13. Directory full. No unused entries are available in the 
directory for the creation of a new file. 

Bit 12. Directory error. An error was returned from physical I/O 
during a direction read or write. Detail physical I/O status 
(DHST) word in DIB is set. This error can occur during a file 
open, close, or directory update. 

Bit 11. End of Media. The end of a partition was reached during 
write on a new file. It is valid for both sequential and random 
access modes. 


Bit 10. Partition(s) busy. The required partition for a new file 
creation already has a new file currently open, (partition is 
busy), or required partition is full. If no partition was 
specified, then all partitions are busy. ‘ 

* Information supplied by user. 
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Bit 9-8. Reserved for future expansion. 

Bit 7. Access mode error. A sequentail access was made on a 
ramdom file or a random access was made on a sequential file. The 
access type did not match file type in a new file open. 

Bits 6-2. Reserved for future expansion. 

Bit 1. Unable to close. Indicates a close was in process when an 
error occurred (file remains open). 

Bit 0. Unable to open. Indicated an open was in progress when an 
error occurred, (file remains closed). 
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^ .2 Manager Controller Information Block (CIB) 

The*Controller Information Block (CIB) is used for storing and/or transferring infor¬ 
mation between the File Manager and the IOX I/O handler. Words 15-19 must contain the 
described information upon initial entry to the File Manager (actually to IOX) . 

igure 5-7 illustrates the CIB configuration. The functions of each CIB word are 
^escribed below. Word 0, words 15-19 and words 24-33 are defined the same for the File 
Handler as they are for IOX. 


Word 0 


SIO: beginning of record flag. 


Words 1-10 


I OB used by the File Manager for physical I/O; includes user- 
supplied LUN for the file device (IOB word 4 =» CIB word 5) . All 
other data in IOB is supplied by the File Manager. The IOB status 
word is transferred to the DIB physical I/O error status word after 
each IO: call. 


Word 11 


Number of physical sectors per physical record (supplied by the 
File Manager). , 


Physical sector address of Volume Table of Contents (VTOC). 
Initialize to zero. The File Manager determines the VTOC address 
(0 or :29) on first open. 


Word 13 


Address of Disk Descriptor Table (DDT) (supplied by the File 
Manager after first open). This is a physical record address. 


Word 14 


Words 15-18 


Open/close buffer address. This word contains .the word address (no 
indirection) of a 256-word buffer supplied by the user. This 
buffer is used by the File Manager for directory searching during 
open or close processing. 

Entry point jump table. 


Word 15 
Word 16 
Word 17 
Word 18 


Read 

Write 

Position 

Function 


FM:REA 
FM:WRT 
FM:POS 
FM:FUN 


Special operation entry point. Not used; set to zero. 


W -d 20 


Current direction record number during open, or operation code 
during position/function processing (supplied by the File Manager) 


Word 21 


Number of directory entries used during open, or absolute file 
position court during position processing (supplied by the File 
Manager). 


Word 22 


Number of directory entries available during open or current file 
position during position processing. Supplied by the File Manager. 
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SIO: BEGINNING OF RECORD FLAG 
PHYSICAL I/O 
^ IOB 

NUMBER OF SECTORS/RECORD 
VTOC ADDRESS 
DDT ADDRESS 
OPEN/CLOSE BUFFER 

STANDARD 

FOR 

CIB 


CSPR 

CVTOC 

CDDT 

COCB 

CJTB 



CURRENT DIRECTORY RECORD 
DIRECTORY ENTRIES USED 
DIRECTORY ENTRIES AVAILABLE 
PARTITION BUSY FLAGS 


CCDR/CPFC 

CVND/CAPC 

CVDA/CCPC 

CPBS 



STANDARD 

FOR 

CIB 


SUBROUTINE 

LEVEL 

5 

RETURN 

LEVEL 

4 

ADDRESS 

LEVEL 

3 

SAVE 

LEVEL 

2 

AREA 

LEVEL 

1 


FILE LINKAGE 
BUFFER 


CRrxxx WHERE 


XXX = SUBROUTINE NAME 


CLKBF 


Figure 5-7. CIB Definition When Used With the File Manager 
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Word 23 


♦Words 24-33 
Words 34-38 


Words 39-42 


Partition busy flags. Each partition on disk is represented by a 
single bit. The bit position is equal to the partition number. 
With a maximum of 8 partitions numbered 1-8 , only bits 1-8 are 
used- Bits 0 and 9-15 are unused. A partition busy flag is set 
when a new file is open in that partition and cleared when it is 
closed. Only one new file may be open in any one time. Supplied 
by the File Manager. 

Standard CIB definition. 

Subroutine return address save area. 

Word 34 Level 5 subroutines: FM:PS 

FM:FN 

Word 35 Level 4 subroutines: FM:RE 

FM: WR 
FM:OP 
FM :CL 

Word 36 Level 3 subroutines: FM:DM 

FM:EQF 

Word 37 Level 2 subroutines: FM:WBK 

FM:RBK 

FM:HLK 

FMsRLR 

Word 38 Level 1 subroutines: FM:PIO 

Buffer for processing partition file linkage. 
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V.J RTX FIUE LABEL UTILITY 

The RTX File Label Utility is a stand-alone program for labeling file-type devices. 
The RTX/IOX File Manager requires that all file-type devices be labeled prior to use. 
This involves the creation of a Volume Table of Contents (VTOC) and directories on 
ach individual unit to allow later file processing by naine. Do not confuse 
"labeling" with "formatting** of disk packs; the latter must be done with stand-alone 
programs before labeling. The labeled device is compatable with Computer Automation 
OS File Format. 


5-3.1 Environment 

The Label Utility requires an LSI-2 or LS1-3/05 CPU with a minimum of 4K words of 
memory. The tape numbers (binary paper tape) are 93324-40A1 and -41A1 for LSI-2 and 
LSI-3/05, respectively. 

5 3.2 Program Operation * 

JfPter loading and executing, the Label Utility halts with P=:0100 and waits for the 
ier to specify TTY I/O type: 


1. Standard option board TTY, set Sense switch OFF. 

2. DIO TTY, set Sense switch ON. 


To continue execution, depress RUN after setting the desired I/O Option. The Label 
^ gram will then query the user for its variable information. When responding, 
certain keys on the keyboard have special functions. 

;/ 1. Return . The Return key indicates the end of a line of input and causes 

a carriage return and line feed to be generated. 


2. Back arrow (-—). The back arrow causes the previous character input to 
be replaced by the next character typed. Multiple characters may be 
replaced by typing the appropriate number of back arrows followed by the 
correction characters. 

3. Back arrow (•«—)/Return. A back arrow followed immediately by Return 
causes the entire current line to be ignored and replaced by the next 
line input. The Return causes a carriage return and line feed to be 
generated. 


II/5-18 




CompulMAuloiratim 


NOTE 


An invalid response to a query will result in the query being 
repeated. 

The Label Utility begins with the first query: 

DATE? (MMDDYY) 

The user should respond with a Volume Identification. It must consist of one to six 
characters, normally alphanumeric, although any characters are allowed. 

Example: Feb. 4, 1977 would be input as 020477. 

TIME? (HHMMSS) 

Enter the current time of day (hours, minutes, seconds). This time is saved in the 
VTOC. This time is NOT incremented by a real-time clock. This is a 24 hour clock. 

Example: 1:23 PM would be input at 132300. 

VOLUME NAME? 

The user should respond with a Volume Identification. It must consist of 1-6 
characters, normally alphanumeric, although any characters are allowed. 

TYPE AND UNIT NUMBER? 

The response is a two-character specifier of the physical device which is to be 
labeled. The specifiers are: 


DEVICE 

SPECIFIER 

Moving Head Disk, Unit 0 

DO 

Moving Head Disk, Unit 1 

Dl 

Moving Head Disk, Unit 2 

D2 

Moving Head Disk, Unit 3 

D3 

Floppy Disk, Unit 0 

F0 

Floppy Disk, Unit 1 

FI 

Floppy Disk, Unit 2 

F2 

Floppy Disk, Unit 3 

F3 


DOES XX CONTAIN OS? 

If the device to be labeled (xx) contains a copy of the Computer Automation Operation 
System (OS) the user responds with "YES”. Otherwise, the user's response is "NO", 
causing the next query to be suppressed. OS must be on the device before labeling. 
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^ save os? 

If an operating system exists on the Unit and is to be saved, the user responds with 
"YES", otherwise "NO”. 

? the device to be labeled is a disk, the next query is: 

NUMBER OF PARTITIONS? (1-8) 

The user now selects the number of partitions (1-8 J into which the disk is to be 
divided and enters that value. Only the first digit entered is used. The number of 
partitions selected is the limit to the number of new files which may be open 
simultaneously (new file creation). 


| The labeling process then begins. When successfully completed, the following message 
| is output: 

I . 

| LABEL COMPLETE 


he selected device is off-line, not ready, write protected, or othewise mal 
tions during the labeling process, the following message is output: 


HARDWARE ERROR 
RETRY? 


If the user responds with "YES", the program will retry the label process. If the 
device still fails, the error message is repeated. If the user responds with "NO", 
the labeling process is aborted and the Program continues with the next query. 

C LABEL more? 


\ user is offered the option of labeling another device or terminating the process. 
A "YES" response will cause a restart with the query "VOLUME NAME?". If the user 
wishes to change the date and time and continue, the response is "NO". A "NO" 
response will halt the CPU. Depressing RUN will restart the program at the beginning. 
At this point, a new I/O option may be selected. 



NOTK 


The restart entry point is :0101. The LSI 3/05 version contains 
a software console routine for restarting (CNS0L3). 
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SECTION 6 


DEVICE-DEPENDENT CONSIDERATIONS 


The device-dependent functions of IOX are the responsibility of the individual device 
handlers. Initially IOX performs all parameter validation and error checking before 
control is transferred to the appropriate device handler. The device handler will 
execute the data transfer and perform the device testing. Note that the bit con¬ 
figuration for each function (bits .3-0 of IOB word 5) is listed below each operation 
in parentheses. * - > 


©.1 


STANDARD CHARACTER DEVICE HANDLERS 


6.1.1 Line Printer (LP) 


Write (formatted ASCII) 
( 0110 ) 


Outputs up to 132 (or less if the printer is not 
that wide) characters. 


Write file mark 
( 1100 ) 


Outputs /* in columns 1 arid 2. 


All other function codes 


No I/O 


.6.1.2 Teletype Keyboard (TK) 


Write (formatted ASCII) 
( 0110 ) 


Outputs up to 72 characters. Carriage return, line 
feed are appended to the end of each record. 


Write (unformatted) 
( 0101 ) 


Outputs up to 65,535 characters exactly as in the 
user's buffer. 


Read (formatted ASCII 
( 0010 ) 


Inputs from the keyboard until a carriage return is 
read. Standard character editing is active. 


Read (unformatted) 

( 0001 ) 

Write File Mark 
( 1100 ) 

All other function codes 


Inputs from the keyboard until the number of char¬ 
acters requested is input. 

/* is output followed by carriage return, line 
feed. 

No I/O 
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ComputerAutomation 


.1.3 Teletype Console (TY) (implies tape reader or keyboard for input, whiehevei i:. 
^ ready) 


Write (formatted ASCII) 
( 0110 ) 


Outputs up to 72 characters. Carriage return and 
line feed are appended to the end of each record. 


Write (unformatted) 
( 0101 ) 


Outputs up to 65/535 characters exactly as in the 
user*s buffer. 


Read (formatted ASCII) 
( 0010 ) 


Read (unformatted) 
( 0001 ) 


Write File mark 
( 1100 ) 


Inputs (from the tape reader, if ready, otherwise 
from the keyboard) until a carriage return is read. 
Standard character editing is active. 

Inputs (from the tape reader, if ready; otherwise 
from the keyboard) until the requested number of 
characters is input. 

/* is output, followed by carriage return, line 
feed. 


All other function codes 


No I/O 


Teletype Reader (TR) 

Read (formatted ASCII) 
( 0010 ) 


JRead (unformatted) 

( J001) 

, *~ead (formatted binary) 

x ,0011) 


Inputs up to 256 ASCII characters from the reader 
(does NOT echo on printer) until a carriage return 
is read. Standard character editing is active. 

Inputs from the reader (does NOT echo on printer) 
until the number of characters requested is input. 

Reads one binary record and checks the checksum. If 
a checksum error is detected, the error status will 
be set. 


All other function codes 


No I/O 


l.( Teletype Punch (TP) 


T ' T rite (formatted ASCII) 

( . 110 ) 

Write (formatted binary) 
( 0111 ) 


Outputs up to 256 ASCII characters. Carriage return 
line feeds are supplied at the end of each record. 

Outputs up to 65,535 bytes in IOX binary format. 


Write (unformatted) 
( 0101 ) 


Outputs up to 65,535 bytes exactly as in the user’s 
buffer. 


Wi I to Ki1e Mark 
( 1100 ) 


Output?: Kh!m>uI ~Nii 11-Nu I J on the pap*»r t.ipi*. 


Punch Leader 
( 1101 ) 


Outputs 12 inches of leader. 


All other function codes 

L 


No I/O 
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.1.6 Card Reader (CR) 

. Read (formatted ASCII) 
( 0010 ) 


Read (formatted binary) 
( 0011 ) 

All other function codes 
\ 

6.1.7 High Speed Reader (PR) 

Read (formatted ASCII) 
( 0010 ) . 

Read (unformatted) 

( 0001 ) 

Read (formatted binary) 
( 0011 ) 

All other function codes 



* 


One card will be read. The maximum number of bytes 
transferred is 80. If the first two columns contain 
/* an end-of-file is assumed. 

To be specified ... if the first two columns 
contain /* an end-of-file is assumed. 

No I/O 


Inputs from the reader until a carriage return is 
read. Standard character editing is active. 

Inputs from the reader until the number of characters 
requested is input. 

Reads one binary record and checks the checksum. If 
the checksum is in error the error status is set. 

No I/O 


Outputs up to 256 ASCII characters. Carriage return 
line feeds are supplied at the end of each record. 

Outputs up to 65,535 bytes in the IOX binary format. 

Outputs up to 65,535 bytes exactly as in the user’s 
buffer. 

Outputs Rubout, Null, Null on the paper tape. 

Outputs 12 inches of leader. 

No I/O 

6.2 FORTRAN LIST DEVICE HANDLER 
6.2.1 Line Printer (LPF) 

Write (formatted ASCII) Outputs up to 132 characters, preceded by a carriage 

(0110) control character ("1" = top of form, "0” = double 

| upspace, any other *= single upspace). 

I 

c 
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6.1.8 High Speed Punch (PP) 

Write (formatted ASCII) 
( 0110 ) 

Write (formatted binary) 
( 0111 ) 

/ 

Write (unformatted). 
( 0101 ) 

Write File Mark 
( 1100 ) 

Punch Leader 
( 1101 ) 

All other function codes 
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Write file mark 
( 1100 ) 


Outputs "/*" in columns 1 and 2. 


All other function codes 


No I/O 


6.2.2 Teletype Keyboard (TKF) 

Write (formatted ASCII) 
( 0110 ) 


Write (unformatted) 
( 0101 ) 

Read (formatted ASCII) 
( 0010 ) 

.Read (unformatted) 

' ( 0101 ) 

Write File Mark 
( 1100 ) 

All other function codes 


Outputs up to 72 characters, preceded by carriage 
control character ("1” = top of form = 6 upspaces, 
"0" = double upspace, any other = single upspace). 

Outputs up to 65,535 characters exactly as in the 
user’s buffer. 

Inputs from the keyboard until a carriage return is 
read. Standard character editing is active. 

Inputs from the* keyboard until the number of char¬ 
acters requested is input. 

/*• is output followed by carriage return, line feed. 


No I/O 


Teletype Console (TYF)(implies tape reader or keyboard for input, whichever is 
ready) 


Write (formatted ASCII) 
( 0110 ) 


Write (unformatted) 
( 0101 ) 

Read (formatted ASCII) 

I (0010) 


Read (unformatted) 
( 0001 ) 


Write File mark 
( 1100 ) 


Outputs up to 72 characters, preceded by carriage 
control character Cl" = top of form = 6 upspaces, 

"0" =■double upspace, any other = single upspace). 

Outputs up to 65,535 characters exactly as in the 
user’s buffer. 

Inputs (from the tape reader, if ready, otherwise 
from the keyboard) until a carriage return is read. 
Standard character editing is active. 

Inputs (from the tape reader, if ready; otherwise 
from the keyboard) until the requested number of 
characters is input. 

/* is output, followed by carriage return, line feed. 


All other function codes 


No I/O 
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^ 6.3 MAGNETIC TAPE HANDLER 

6.3.1 Magnetic Tape (MT) 

Write (formatted ASCII, 
formatted binary, or 
unformatted) 

(0110, 0111, or 0101) 

Read (formatted ASCII, 
formatted binary, or 
unformatted) 

(0010, 0011, or 0001) 


Ck>mputwAutom®tk>n 


Outputs 1 to 65535 bytes as a single record. 


Inputs one record up to 65,535 bytes. If the 
actual record is longer than the requested number 
of bytes, only the requested number will be input. 
If the actual record is shorter than the requested 
input, only the actual number of bytes are input. 
Up to ten retries will be made in the event of a 
parity error before an error status is returned to 
the caller. 



Position Relative Records 

( 1010 ) 




Position Relative Files 
( 1011 ) 



Position Absolute Records 
( 1000 ) 


Skips the number of records in the requested count. 
A positive count indicates forward skips. A 
negative count indicates backward skips. If a file 
mark is encountered during the positioning, the 
operation is terminated, and the number of records 
actually skipped (not including the file mark) is 
returned along with an end-of-file status. The 
tape is left positioned prior to the file mark (the 
file mark is never actually crossed and movement is 
effectively bounded within a pair of file marks). 

If an end of tape or beginning of tape marker is 
found during positioning, the operation is te 
terminated with the actual count returned and an 
end-of-device status. 

Skips the number of file marks in the requested 
count. A positive count indicates forward skips. 

A negative count indicates backward skips. Upon 
return, the tape is positioned past the last file 
mark skipped. If an end-of-tape or beginning-of- 
tape mark is encountered, the operation is termi¬ 
nated with the actual skip count returned, along 
with the appropriate end-of-device status. 

The tape is first rewound to load point, then 
skipped forward the number of records requested. 

The requested count must be positive. If the count 
is zero, the tape is left at load point. 


Position Absolute Files 
( 1001 ) 


(L 


Write File Mark 
( 1100 ) 

All other operations 


The tape is first rewound, then skipped forward the 
number of files requested. The requested count 
must be positive. If the count is zero, the tape 
is left at load point. 

A write file mark function is issued to the tape 
unit. 

No I/O 
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?! 

I • 6.4 DISK, STORAGE MODULE DISK, AND FLOPPY DISK HANDLER 

I r 

| 6~. 4 .1 Disk (DK) , Storage Module Disk (SM) , and Floppy Disk (FD) 


. - V 





write Direct Access 
( 0100 ) 


Writes to the disk the number of bytes specified by 
the user in IOB Word 6, to the relative record 
number specified in IOB Word 9. Upon completion of 
the operation, this record number is incremented. 


Read Direct Access 
( 0000 ) 


Reads from the disk the number of bytes specified 
by the user in IOB Word 6, from the relative record 
number specified in IOB Word 9. Upon completion of 
the operation, this record number is incremented. 


All other function codes No I/O 




. The Floppy Disk Handler supports only one fbyppy disk controller. The 
^handler must not be used concurrently with a storage module disk controller. 

w 

The Storage Module Disk Handler supports only one storage module disk 
controller. The handler must not be used concurrently with a floppy disk 
controller. 


6.4.2 Fortran Disk (DKF), Storage Module Disk (SMF), and Floppy Disk (FDF) 


;7rite (formatted ASCII, 
formatted binary) 

(0110 or 0111) 


Outputs to the disk the number of bytes specified 
by the user, to the relative record number main¬ 
tained in DIB Word 15. Upon completion of the 
operation, this record number is incremented and 
stored into IOB Word 9. 


Read (formatted ASCII, 
formatted binary) 

(0010 or 0011) 


( ?osition Relative Records 
( 1010 ) 



Inputs from the disk the number of bytes specified 
by the user, from the relative record number main¬ 
tained in DIB Word 15. Upon completion of the 
operation, this record number is incremented and 
stored into IOB Word 9- 

The requested count (positive or negative) is added 
to the current relative record number maintained in 
DIB Word 15. (No actual I/O occurs). The new 
record number is also copied into IOB Word 9- If 
the resultant relative record number is greater 
than the highest sector number in the extent, the 
highest sector number is stored, and the end-of- 
device status is returned. If the resultant rela¬ 
tive record number is negative, a zero (represent¬ 
ing the first record of the extent) is stored, and 
a beginning-of-device status is returned. 
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Position Absolute Records 
( 1000 ) 


The requested count (which represents the actual 
record number to be positioned to), is stored into 
DIB Word 15 and I0B Word 9. No actual I/O occurs. 
If the record number is greater than the highest 
sector number in the extent, the highest sector 
number is stored, and the end-of-device status is 
returned. If the record number is negative, a zero 
(representing the first record of the extent) is 
stored, and a beginning-of-device status is re¬ 
turned. 


Write File Mark 
( 1100 ) 


A two character record containing "/*” is written 
into the record pointed to by the Relative Record 
Count, then this count is incremented and copied 
into I0B Word 9. 


All other function codes 


No I/O. 


j NOTg I 

The Floppy Disk Handler supports only one floppy disk controller. The 
handler must not be used concurrently with a storage module disk controller. 

The Storage Module Disk Handler supports only one storage module disk 
controller. The handler must not be used concurrently with a floppy 
disk controller. 


6.5 MAGNETIC TAPE INTELLIGNET CABLE (MTIC) HANDLER 


Write forward 
(ASCII or Binary) 
(0110 or 0111) 


Outputs 1 to 65,535 bytes as a single record. 
Records containing a byte count less than the 
minimum record length (DIB word 12) will have 
additional characters appended to the record until 
the byte conct is equal to the minimum record 
length. Blanks are appended to ASCII records and 
zeros are appended to Binary records. 


During write operation error recovery, the tape is 
backspaced one record and another write is attemp¬ 
ted. Up to ten retries are made in the event of a 
rate error (processor workload error) . Up to three 
retries are made in the event of a hard error (tape 
error); subsequently, a fixed length erase function 
is used to erase the hard error region and three 
more retries are executed. This erase procedure is 
executed up to ten times, at which point an error 
status is returned. (Note: Hard error recovery is 
modified if the Control Edit function is on. Refer 
to the Control Edit description.) - 


Error county for each type of recovery are returned 
to DIB word 10. 
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^ Read (forward, reverse) 
^ (ASCII, Binary), 

Read Reverse 
( 0010 , 0011 , 0000 ) 


Inputs one record up to 65,535 bytes. If the 
actual record is longer than the requested number 
of bytes, only the requested number is input. If 
the actual record is shorter than the requested 
input, only the actual number of bytes are input. 
Up to ten retries are made before an error status 
is returned. 


Position Relative Records 
( 1010 ) 


Skips the number of records in the requested 
count. A positive count indicates forward skips. 

A negative count indicates backward skips. If a 
file mark is encountered during the positioning, 
the operation is terminated, and the number of 
records actually skipped (not including the file 
mark) is returned along with an end-of-file status. 
The tape is left positioned prior to the file mark 
(the file mark is never actually crossed and 
movement is effectively bounded within a pair of 
file marks). If an end of tape or beginning of 
tape marker is found during positioning, the 
operation is terminated with the actual count 
returned with an end-of-device status. 


Position Relative Files 
( 1011 ) 


Position Absolute, Records 
( 1000 ) 


position Absolute Files 
( 1001 ) 


Write File Mark 
( 1100 ) 

Control Edit 
( 1110 ) 


Skips the number of file marks in the requested 
count. A positive count indicates forward skips. 

A negative count indicates backward skips. Upon 
return, the tape is positioned past the last file 
mark skipped. If an end-of-tape or beginning-of- 
tape mark is encountered, the operation is termina¬ 
ted with the actual skip count returned with the 
appropriate end-of-device status. 

The tape is first rewound to load point, then 
skipped forward the number of records requested. 

The requested count must be positive. If the count 
is zero, the tape is left at load point. If the 
count is minus one, the unit is placed offline. 

The tape is first rewound, then skipped forward the 
number of files requested. The requested count 
must be positive. If the count is zero, the tape 
is left at load point. If the count is minus one, 
the unit is placed offline. 

A write file mark function is issued to the tape 
unit. 

This function causes the formatter to implement 
special head positioning to allow record updating. 
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Control Erase 
( 1111 ) 


I MOTS I 

Control Edit needs to be used with 
caution because of possible "tape 
creep”. Refer to the Distributed 
I/O System User's Manual, Publication 
No. 91-53629-OOB2, for a more 
detailed explanation. 

Control Edit requires five calls to 10:. Call one 
positions the tape at the end of the record to be 
updated. (An inter-record gap containing an era¬ 
sure or noise record might be found between the end 
of this record and the beginning of the next rec¬ 
ord.) Call two sets the edit function on. Call 
three performs a skip or read reverse function for 
the current record. Call four performs a write 
forward function for the new record. The byte 
counts for the new and old records must be equal. 
Call five set the edit function off. 

Hard error recovery for write operations is mod¬ 
ified when Control Edit is on. Up to three retries 
are made in the event of a hard error; subse¬ 
quently, an error status is returned. 

This function performs a fixed length (filemark) or 
variable length erase. The erase mode bit is set 
to override a write operation. This function can 
be used with Control Edit to erase a record in 
place. 

Control Erase requires three calls to IO: . Call 
one sets Control Erase on. Call two performs a 
write or write file mark function. Call three sets 
Control Erase off. 


All other function codes 


No I/O. 


6.6 STANDARD CHARACTER EDITING 

In order to facilitate input from an operator, IOX supports character editing on input 
from all keyboard and paper tape devices. Three editing functions are supported by 
IOX. 


Backsapce. Character backspace is implemented using the back arrow (—) char¬ 
acter. One character is erased for each*back arrow character input. Since it is 
impossible to physically backsapce on a teletype, the back arrows are echoed on 
the printer. Note that the character editing will take place over the le.ngth of 
the entire physical record, not just until the number of currently valid char¬ 
acters equals the requested count. 
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2 ^ Iynore entire input. Occasionally the operator decides it would be easier to 
start over rather than backspace and correct all of the errors on the current 
input. IOX supports this by deleting the entire input and restarting whenever 
the back arrow is typed followed immediately by a carriage return. 

3 [ Ignore this character. This is useful when the input is from a paper tape which 
was prepared off-line on a teletype. The punch on a teletype has a local back¬ 
space feature, and the most common means of correcting a tape such that it prints 
proprely when read off line is to backspace the punch over the offending char¬ 
acter (s) and punch rubout(s) on top of them. IOX will read such tapes properly 
by ignoring all rubouts. In addition, IOX will read such tapes properly by 
* ignoring all rubouts. In addition, IOX ignores all line feeds and all other 
characters whose ASCII code is less than :0D (e.g., bell, leader). 

Since an end-of-file is defined as a Rubout, Null, Null on paper tape, and since it is 
difficult to enter Rubout, Null, Null on a keyboard, IOX recognizes two different end- 
of-file marks in the standard character editing mode for formatted ASCII input. These 
fi^ marks are Rubout, Null, Null or /*. Either of these character sequences input at 
thtajjieginning of a record will cause an end-of-file to be recognized. 

( ' 
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SECTION 7 

NON-STANDARD HANDLER DESCRIPTIONS 


Some IOX handlers do not conform to the standard I OB, DIB , and CIB configurations 
described in sections 2 and 4. This section describes the software tables and device- 
dependent functions of these IOX handlers. (The A/D, D/A handler is described in 
Publication No. 93325-00.) 

V 

7.1 IEEE INTELLIGENT CABLE (IEC) HANDLER 

iQrhe IEC Handler controls the operation of the*IEEE Intelligent Cable. The IEC Handler 
^and the IEEE Intelligent Cable together conform to the requirements for an IEEE (STD 
488-1975) interface system controller. The IEEE Intelligent Cable provides the hard¬ 
ware to drive the IEEE interface bus and the firmware to conduct both the Source 
Handshake and the Acceptor Handshake. It also senses the state of the IEEE Interface 
Bus. The IEC Handler implements the remaining IEC functions. The interfaced devices 
must have no controller capabilities. 

\C efer to the Distributed I/O System User’s Manual (revision B2 or higher) and IEEE 
^document 488-1975, "IEEE Standard Digital Interface for Programmable Instrumentation" 

| for detailed IEEE function descriptions. 

Note that an arbitrary distinction is made between the terms "control" and "data" with 
respect to IEC handler message transfers. "Control" refers to bytes which are sent 
over the interface bus while ATN is true. "Data" refers to bytes- which are sent or 
received over the interface bus while ATN is false. 
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.id I EC IOB Configuration — 9 to 12 words. 

n *•;» 

igure 7-1 illustrates the IOB configuration for the IEC Handler. 


INPUT/OUTPUT BLOCK 

FOR THE IEEE INTELLIGENT CABLE HANDLER 


Standard 

Name 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 


STANDARD IOB 


CONFIGURATION 


ISTA,IOP I s 



IRCNT 


IBUFF 


1 


NO 

BAD 


DE- 

OP OR 

IN- 

RES. 

I/O 

LUN 

0 

VICE 

TERM 

COND. 

TERN 



OP 

OP 

CODE 

MOD. 


USED 

FOR 

ALL 

REQUESTED 

FUNCTION 

CODES 

USED 

FOR 

ALL 

REQUESTED 

FUNCTION 

CODES 

USED 

FOR 

ALL 

REQUESTED 

FUNCTION 

CODES 


IRCNTU 


USED IF OP CODE IS 00 OR 01 


IBUFFU 


USED IF OP CODE IS 00 OR 01 


ITIME 


USED IF OP CODE IS 00 OR 01 


Figure 7-1. IOB Configuration 
IEC Handler 
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»rmat of the IOB after the first six words is determined by bits 3-0 of word 


5. 


^ Op Code 
(bits 3 and 2) 


00 

00 

01 

01 

01 

01 


Format 1 


Op Modifier 

(bits 1 and 0) Function 


01 

11 

00 

01 

10 

11 


Write control and read data to END. 

Same as 0001 with parity standardization 
Write control and write data. 

Write control and write data with END- 
Write control only. 

Write control and ignore data. 



word 

6 

7 

8 . 

9 

10 

11 


x 


( 

rd 7 


rd 8 


Data Request Count. This word is supplied by the user to specify the 
number of data bytes to be transferred. This word must not be zero. 


Data Buffer Address. This word is supplied by the user to specify the 
starting address of the data buffer. Note that this address is always 
a word address and that indirect addressing is not allowed. 


Actual Data Transfer Count. This word contains the number of data 
bytes transferred when the operation is completed. This word is 
returned by IOX at the completion of I/O. 


,c 
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Word 9 
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Control Request Count. This word is supplied by the user to specify 
the number of control bytes to be transferred. No control bytes are 
transferred if this word is zero. 


Word 10 


Control Buffer Address. This word is supplied by the user to specify 
the starting address of the control buffer. Note that this address is 
always a word address and that indirect addressing is not allowed. 


Word 11 Time Limit. This word is supplied by the user to specify the operation 

time limit. If negative, there is no time limit. If positive, a 
"device unresponsive" error will occur if the read or write operation 
has not completed within the number of clock ticks specified. If zero, 
the operation time limit will equal the number of data bytes (IOB Word 
6) modified by the delay modification instruction stored into CIB word 
20. (Refer to the SIO: description in Section 3). 

Cj^Note that the specified number of clock ticks (word 11 positive) applies to data 
PJtransfers only. The time limit for control transfers is always determined by the byte 
( count and CIB word 20. 


Format 2 


Op Code Op Modifier 

(Bits 3 and 2) (bits 1 and 0) 



(. 


Word 6 Clock Ticks. This word is supplied by the user to specify the number 

of clock ticks before SRQ is found. No time limit is applied if this 
word is negative. If positive, a "device unresponsive" error will 
occur if SRQ is not found within the number of clock ticks specified. 
This word may not be zero. 

Words 7 and 8 are not used but must be provided. 
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REGULAR DIB 


z 

7 

CONFIGURATION 



! ' 0 ■ ■■ 

0 

_ L _ 


0 

o 











CocnputsrAutoenatbn 


Mama 

CBOR 

CSEL7 


CTHP1 

CTKP2 

CTHP3 

CEBTSK 

CNEWA 

CKEWX 

CAIDL 

CDOG 

REQCtrr 

CJTBL 


IEC CONTROLLER INFORMATION BLOCK 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


CSPLOP 

CDEL 

CINTR 

CADDLY 

CSTPCH 

Cl OB 

COP 

CRCNT 

CBUFF 

CTCNT 

CFCNTU 

CDIB 

CBUFFU 

STATUS 

CRTH 


TC FOR IEiSIO—BEGINNING OF RECORD FLAG 

TC FOR IEiSIO—SEL DA,7 

J ST INTQ: 

• 

DATA $ CALLING LOC 

DATA 0 TEMP 1 

DATA 0 TEMP 2 

DATA 0 TEMP 3 

DATA INTP: TASK ADDRESS 

DATA 8180 PRIORITY 

DATA 0 . * 

DATA $-10 

DATA $-11 

CURRENT PICO IDLE STATE—INITIALIZE TO 0 

WATCHDOG FLAG FOR IEiSIO 

TC 

DATA IECR: 

DATA IECW: 

DATA 0 

DATA IECFx 

DATA 0 

TC FOR IEiSIO—WATCHDOG TIMER INSTR. (NOP) 

TC FOR IEiSIO-- JEC WORD INTERRUPT ADDR. 

TC FOR IOX—TIME DELAY FROM IOB 

TC FOR IOX—STOP CHARACTER 

TC FOR IOX—IOB ADDR. 

TC FOR IOX SCHED—OP CODE AND STATUS (IOB vd 5) 

TC FOR IOX SCHED—REQUESTED DATA COUNT (JOB vd 6) 

TC FOR IOX SCHED—DATA BUFFE,< ADDR (IOB vd 7) 

TC FOR IOX--ACTUAL DATA BYTE COUNT (IOB vd 8) 

TC FOR IOX SCHED—REQUESTED CONTROL COUNT (IOB vd 9) 

TC FOR IOX SCHED—DIB ADDR AND BUSY FLAG 

TC FOR IOX SCHED—CONTROL BUFFER ADDR (IOB vd 10) 

TC FOR EOR:—STATUS 

TC FOR IEiSIO—RETURN ADDRESS 


Word 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 NOTE* 

16 TC - Temp Cell 

17 

18 

19 

20 
21 
22 

23 

24 

25 

25 

27 

28 

29 

30 

31 

32 

33 




Figure 7-4. IEC CIB Configuration 
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7.1.4 ]EC fX: v i ce~ Dope rule n t Considerations 


Write Control and Read 
Data to END 
( ( 0001 ) 


The contents of the control buffer (IOB word 10) 
are sent with the source handshake while ATN is 
true. The control buffer will usually contain 
interface commands which address a peripheral as 
the talker. The IEC then initiates the acceptor 
handshake. The peripheral will transmit data when 
ATN is false. The IEC receives data until an END 
message was received with a byte or the Auto I/O 
byte count reached zero. 



Write Control and Read 
Data to END with Parity 
Standardization 
( 0011 ) 


The handler will set bits 9 and 8 of IOB word S to 
the appropriate termination condition. The number 
of bytes transferred is returned to IOB word 6. 

A read data to END only operation is performed by 
issuing requested function code 0001 with the 
control request count (IOB word 9) equal to zero. 

This function is the same as function code 0001; 
during input, however, the I/O Distributor performs 
parity standardization on all data bytes. 


Write Control and 
f Write Data 
~ ( 0100 ) 



Write Control 
Data with END 
( 0101 ) 


and Write 


Write Control Only 
( 0110 ) 


The control buffer is transmitted using the source 
handshake while ATN is true. The control bytes 
will’ generally address a peripheral to accept 
device programming. ATN is driven false following 
termination of the control sequence, and the data 
buffer is transmitted using the source handshake. 

A write data only operation is performed by issuing 
requested function code 0100 with the control 
request count (IOB word 9) equal to zero. 

This operation is the same as function code 0100 
except that the last byte of data is sent with the 
EOI control line true, indicating an END message. 

A write data with END only operation is performed 
by issuing function code 0101 with the control 
request count (IOB word 9) equal to zero. 

\ 

The control buffer is transmitted using the source 
handshake while ATN is true. The data request 
count (IOB word 6) must not t be set to zero. The 
IEC will maintain control of the IEEE interface 
after the transfer by setting NRFD true. 
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Write Control and 
Ignore Data 
( 0111 ) 


Wait for SRQ 
( 1000 ) 


Get IEC Status 
( 1100 ) 

Set IEC Control Lines 
( 1101 ) 


Get Parallel Poll Response 
( 1110 ) 


All Other Function Codes 


The control buffer is transmitted using the source 
handshake while ATN is true. ATN is driven false 
and remains false following termination of the 
control sequence. Peripheral to peripheral data 
transfers may occur with the IEC in this state. I 
Any read or write request following this function^ 
will be prefaced with a Take Control Synchronously * 
operation so the IEC will regain control of the 
IEEE interface. 


The IEC is instructed to wait until the IEEE 
control line SRQ is found true. The handler will 
return immediately if SRQ is true when the request 
is made. 


The IEC status is returned to IOB word 8. 


IEEE control lines ATN# REN# IFC# EOI # and SRQ 
assume the values contained in IOB word 6. This 
function allows the transmission of interface 
messages which involve these control lines# such as 
"interface clear" and "remote enable". Note that 
the handler changes the values of all these lines 
when performing other operations. 

An IDY remote message is sent for parallel polling. 
When the IEC is ready# the handler returns the 
result of the parallel poll to IOB word 8. 

No I/O 
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THE RTX SCHEDULER 
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! Er.) :-.... 


SUBJECT: 


In a typical application system based on LSI-Series 
computers, several independent external activities 
must be processed in the same time frame (for instance, 
a system may perform a test operation while the 
line printer is printing the results of the previous test, 
and the teletype is inputting parameters for the next 
test). 


V, / . 


* C: ■ 1 " 


Sic. 
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ers 


fib 


r;cn 


This implies that the system will be able to recogniz.e 
events (probably via interrupts) and schedule appropriate 
service activities to process the events in a timely fashion. 
Generally, the most effective mechanism to accomplish this 
recognition and scheduling process is the Real-Time 
Executive (RTX). TAB/DB1-Q4 (TRN 93300-03-01-XX) discusses 
the recognition process and the insertion of new activities 
into the stream of ongoing activities (via INTQ:). 

This TAB discusses the actual scheduling mechanism,SCHED:. 


| Vcrbeck 





The function of SCHED: can be described quite simply: 

If there are no activities to be performed, wait until there 
is one; if there are, merge -the list of new activities (created 
by INTQ:) into the list of ongoing activities, according to 
priority,and cause the highest., priority activity to be 
executed. \ 

The term ’’activity" is nebulous; describing a whole class of 
"things to be processed," including interrupt service 
subroutines, Auto I/O,.DMA, and tasks. The term "task" 
is much more definable, and In the context of RTX means 
precisely: "A program or set 'of programs which operates 

to-perform a specific function within the Real-Time -application. 

A discussion of the difference between the two terms 
will clarify the operation of the system. When a user 
starts the execution of a task (by a call to BEGIN: 
or INTQ:), he is starting one or more activities, depending 
on the operation of the task. 


For example: 

• ’ « 

1. A task is currently.executing—this is one 

activity. Somewhere along the line an interrupt 
occurs, and .the execution of the activities 
required to service the interrupt temporarily 
suspends the current task--and terminates the 
current activity. When the task is resumed, it will 
still be the same task, but of course, it is 
now a different activity. 


TRN 933nn-n?-m-m 
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THE RTX SCHEDULER (continued) 


2. A task—one activity--calls DELAY:, suspending 

the task, and terminating the activity. There is 
still an activity associated with the task 
' though--the "active" delay. 

Some activities such as an interrupt service subroutine, 
occur without intervention by RTX. Other activities, like 
those described above, must each be regarded by RTX as an 
entity, and kept track of in some manner. 

The RTX work area contains a user-defined number of 5,-word 
blocks (see section 2 of the RTX User's Manual). One of 
these blocks is used to record each activity known to the • . 
system. The table in the RTX manual shows the number of 
work area blocks allocated for each call for RTX service. 

This number is also the net gain or loss -in number of 
activities in the system. 

The user's initial call to RTX: causes his defined work 
area to be broken up into 5-word blocks. Each of these blocks 
contains, in the first word (word 0), a pointer to the next 
block, thus forming a "linked list" of available blocks-- the 
FREE list. A pointer to the first of these available blocks is 
maintained at the location called FREE (at 7RF--see section 
4 of the RTX User's Manual). One of these blocks is immediately 
allocated to contain information about the current activity-- 
the initialization task. * (This block is placed at the top 
of the READY list, see below.) 

Besides the FREE list, .RTX maintains a number of other 
lists. This TAB is concerned with only two of them, the READY 
list and the FIFO list. The READY list (0RF) contains blocks, 
linked in priority order, describing activities that are 
"ready" for service by the processor. The first of these (the 
"top" block) is the activity currently being processed, and 
is always the highest priority activity on the list* If there 
are no blocks on the READY list, this implies that--as far as 
RTX is concerned--the processor is idle (actually it is 
always doing something--note the "wait loop" in the attached 
flow chart). 

Since these lists are linked, they must be maintained carefully. 
If an RTX service routine were .in the process of changing 
the links in one of these lists, and an interrupt ocurred, 
the interrupt service activities could try to use the same list, 
which would be a disaster. 

It is the responsibility of INTQ: to prevent this from 
happening. This imposes two requirements: if an RTX 
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THE RTX SCHEDULER (continued) 


service routine is interrupted, it must be completed before 
any further service is performed; and INTQ: must not alter 
the linkage in any list that is also altered in a routine that 
may have been interrupted. 



( 


Therefore, a special list is used for the "handshake" between 
INTQ: and SCHED:-- the FIFO list (lRF,.the name means 
nothing). This list is maintained very carefully. INTQ: 
puts any new activities to be queued at .the top of this list, 
and SCHED: carefully removes these, one at a time, and places 
them in the READY list in priority order. Once all of" 
these have been placed, the scheduler is ready to set up 
the highest priority activity to be processed. ' (Once it has 
done this, it must check the FIFO'list once more to see if 
an interrupt ocurred during the scheduling process.) 




Each of the blocks on the READY and FIFO lists has the following 
format: 


pointer 
from previous 
block or head 
of list 


Where: 




PRIO 


X 


pointer 
to next block 
or zero if 
no more 


PRIO. 


P 

A 

X 


is the priority of the activity (exclusive 
or'd with :1000 and shifted left three bits). 
Bit .2 of this word contains EIN indicator 
from processor status--always enabled. Bit 1 
contains the byte/word indicator.Bit 0 contains 
the OV indicator. 

is the contents of the program counter for 
the activity (i.e., where it is to be entered), 
is the A register contents for the activity, 
is the X register contents for the•activity. 


Let’s go through an example of the operation of the scheduler. 


The system is initialized 


WKAREA 

RES 

25,0 

MAIN 

JST 

RTX: 


DATA 

5 


DATA 

WKAREA 


HLT 





by the following call: 

Reserve 5 five-word blocks 
Initialize RTX •. 

... using 5 blocks 
... allocated here 
Return to here if 

1) we run out of blocks, or 

2) an RTX. service other than INTQ: 
is called when 
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THE RTX SCHEDULER (continued) 

there is no current activity 
at the top of the READY 
- list. 

# 

Return to here to continue 
initialization 


After completion of this call, the work area has the following 
contents: 



( 








V) Naked Mini. Division 


1«Cr.1 VOM KAIIMAN 


inVItJC, CAUf OMNIA 92CBA 


j j .ci i iv j . an *j. k . 
HUI.l.liTi ;; 


TAB/DB105 
November 19, 1975 


THE RTX SCHEDULER (continued) 

Now suppose "the next thing in the initialization task, (at 
MAIN +4) is the following call to BEGIN: 


JST BEGIN: Queue a task 

DATA TASK1 ... to be entered here 

DATA 100 ... at this priority 

I ... and return to here 

After completion of this call, the work area has the following 
contents: ... 




u ■ 



READY 


1 -o-’ 

_>N 

■—- w — 

0 

° • 


8172 

0 


100 ! 0 

MAIN+7 


TASK1 

rev • 

n 

rev 

rev 


rev ] 


(contents of A S X 
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The highest priority activity on the READY list is still 
the initialization task. Next (at MAIN +7) it does: 

JST END: Terminate initialization 

The work area now looks like this: 



FIFO 



Note that TASK1 is now the highest priority activity, and 
will be executed next. Note also that blocks are returned to 
the end of the FREE list to allow the user to examine the 
history of the system if something goes wrong. 

Therefore, we will begin executing at TASK1. Now suppose, 
for purposes of illustration, that the application program 
has a service subroutine for the console interrupt as follows: 


ABS CONINT interrupt location for console int 
JST *$+l call service subroutine 

DATA CONIS at this location 

REL 0 relocatable portion 

CONIS ENT save P here 

CID turn off interrupt or switch bounces 

JST INTQ: call INTQ: 

DATA ...sec TAB DR/10'i 


data cont:;k,?uo 


n i i 
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o n n 
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THE RTX SCHEDULER 


DATA vala,valx ...pass these values in A 6 X 
DATA CONIS ...address of entry point 

Now suppose that after seven instructions of TASK1, someone 
pushes the console interrupt switch. The interrupt service 
subroutine above will run, and call INTQ:, which will suspend 
the current activity (at TASK1 +7) and queue the console service 
task. 



When INTQ: calls the scheduler, the work area looks like 
this: 



(A, X, S status have changed, 
and TASK1'has been suspended) 
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The scheduler will now merge the FIFO list into the ready 
list, leaving the work area as follows: 
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A content: 



valx 


X content! 


(the new task, CONTSK, 
is higher in priority 
than TASK1) 
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FIFO 
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Now there are two activities on the READY list. The higher 
priority of the two, CONTSK, will be executed first. The 
other activity, TASK1 +7, will be executed when CONTSK 
suspends or terminates (unless something else of a higher 
priority comes in first). 
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KUNDENINFORMATION 


CIB NO 1128 a Real Time Executive (RTX) Version F2 

Mit dieser Information erhalten Sie die neue Version F2 von RTX. 

Es enthalt einen RTX Basis File Manager fur die Handhabung von 
Files im Standard Computer Automation OS File Format (siehe Section 
5) und ein RTX File Label Utility. 

Der File Manager, eingegliedert im IOX, enthalt Eine Directory und 
File Verualtung fur eequentielle Oder random disc storage devices, 
melche' dem Anwenderprogramm erlauben, mit Hilfe von Namen mit Daten 
Files zu korrespondieren. 

Zusatzlich enthalt der File Manager ein automatisches Blocken und 
Wichtblocken von Datensatzen mit Zugriff in Speicherreihenfolge. 

Das RTX Label Utility ist ein binares "stand-alone" Programm zum 
Labeln von dateiorientierten Geraten. Dab Labeln mit diesen Utility 
ist compartibel zum Computer Automation DS Datei Format. 

Folgende Dokumentation und Lochstreifen sind beigEfugt: 

Dokumentation : RTX Users Manual Version F2 

Lochstreifen : LSI 2 RTX/IOX Sequent 1 & 2 
93300 - 30 F2 / 31 F2 
LSI 2 RTX File Label Utility 
93324 - 40 A1 
LSI - 2 RTX Demo 
93300 - 33 El 


Technischer Support 
Rohde 



